/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */ /* This code is GPL. */ #include #include #include #include #include "gal/e-util/e-cursors.h" #include "e-table-simple.h" #include "e-table-header.h" #include "e-table-header-item.h" #include "e-table-item.h" #include "e-cell-text.h" #include "e-cell-checkbox.h" #include "e-table.h" #include "table-test.h" /* * One way in which we make it simpler to build an ETableModel is through * the ETableSimple class. Instead of creating your own ETableModel * class, you simply create a new object of the ETableSimple class. You * give it a bunch of functions that act as callbacks. * * You also get to pass a void * to ETableSimple and it gets passed to * your callbacks. This would be for having multiple models of the same * type. This is just an example though, so we statically define all the * data and ignore the void *data parameter. * * In our example we will be creating a table model with 6 columns and 10 * rows. This corresponds to having 6 different types of information and * 10 different sets of data in our database. * * The headers will be hard coded, as will be the example data. * */ /* * There are two different meanings to the word "column". The first is * the model column. A model column corresponds to a specific type of * data. This is very much like the usage in a database table where a * column is a field in the database. * * The second type of column is a view column. A view column * corresponds to a visually displayed column. Each view column * corresponds to a specific model column, though a model column may * have any number of view columns associated with it, from zero to * greater than one. * * Also, a view column doesn't necessarily depend on only one model * column. In some cases, the view column renderer can be given a * reference to another column to get extra information about its * display. */ #define ROWS 5000 #define COLS 4 #define IMPORTANCE_COLUMN 4 #define COLOR_COLUMN 5 /* * Here we define the initial layout of the table. This is an xml * format that allows you to change the initial ordering of the * columns or to do sorting or grouping initially. This specification * shows all 5 columns, but moves the importance column nearer to the * front. It also sorts by the "Full Name" column (ascending.) * Sorting and grouping take the model column as their arguments * (sorting is specified by the "column" argument to the leaf elemnt. */ #define INITIAL_SPEC " \ \ 0 \ 4 \ 1 \ 2 \ 3 \ \ \ " char *headers [COLS] = { "Email", "Full Name", "Address", "Phone" }; /* * Virtual Column list: * 0 Email * 1 Full Name * 2 Address * 3 Phone */ /* * ETableSimple callbacks * These are the callbacks that define the behavior of our custom model. */ /* * Since our model is a constant size, we can just return its size in * the column and row count fields. */ /* This function returns the number of columns in our ETableModel. */ static int my_col_count (ETableModel *etc, void *data) { return COLS; } /* This function returns the number of rows in our ETableModel. */ static int my_row_count (ETableModel *etc, void *data) { return ROWS; } /* This function returns the value at a particular point in our ETableModel. */ static void * my_value_at (ETableModel *etc, int col, int row, void *data) { static guchar t[] = {'A', 0xc3, 0x84, 0xc3, 0x95, 0xc3, 0x94, 0xc3, 0xb5, 0x00}; #if 0 if (col == 1) return "toshok@ximian.com"; #else if (col == 1) return t; #endif else if (col == 2) return "Chris Toshok"; else if (col == 3) return "43 Vicksburg, SF"; else if (col == 4) return "415-867-5309"; else return NULL; } /* This function sets the value at a particular point in our ETableModel. */ static void my_set_value_at (ETableModel *etc, int col, int row, const void *val, void *data) { } /* This function returns whether a particular cell is editable. */ static gboolean my_is_cell_editable (ETableModel *etc, int col, int row, void *data) { return FALSE; } /* This function duplicates the value passed to it. */ static void * my_duplicate_value (ETableModel *etc, int col, const void *value, void *data) { return g_strdup (value); } /* This function frees the value passed to it. */ static void my_free_value (ETableModel *etc, int col, void *value, void *data) { g_free (value); } /* This function creates an empty value. */ static void * my_initialize_value (ETableModel *etc, int col, void *data) { return g_strdup (""); } /* This function reports if a value is empty. */ static gboolean my_value_is_empty (ETableModel *etc, int col, const void *value, void *data) { return !(value && *(char *)value); } /* This function reports if a value is empty. */ static char * my_value_to_string (ETableModel *etc, int col, const void *value, void *data) { return g_strdup(value); } /* We create a window containing our new table. */ static void create_table (void) { GtkWidget *e_table, *window, *frame; ECell *cell_left_just; ETableHeader *e_table_header; ETableModel *e_table_model = NULL; int i; /* Next we create our model. This uses the functions we defined earlier. */ e_table_model = e_table_simple_new ( my_col_count, my_row_count, my_value_at, my_set_value_at, my_is_cell_editable, my_duplicate_value, my_free_value, my_initialize_value, my_value_is_empty, my_value_to_string, NULL); /* * Next we create a header. The ETableHeader is used in two * different way. The first is the full_header. This is the * list of possible columns in the view. The second use is * completely internal. Many of the ETableHeader functions are * for that purpose. The only functions we really need are * e_table_header_new and e_table_header_add_col. * * First we create the header. */ e_table_header = e_table_header_new (); /* * Next we have to build renderers for all of the columns. * Since all our columns are text columns, we can simply use * the same renderer over and over again. If we had different * types of columns, we could use a different renderer for * each column. */ cell_left_just = e_cell_text_new (e_table_model, NULL, GTK_JUSTIFY_LEFT); /* * Next we create a column object for each view column and add * them to the header. We don't create a column object for * the importance column since it will not be shown. */ for (i = 0; i < COLS; i++) { /* Create the column. */ ETableCol *ecol = e_table_col_new ( i, headers [i], 1.0, 20, cell_left_just, g_str_compare, TRUE); /* Add it to the header. */ e_table_header_add_column (e_table_header, ecol, i); } /* * Here we create a window for our new table. This window * will get shown and the person will be able to test their * item. */ window = gtk_window_new (GTK_WINDOW_TOPLEVEL); /* This frame is simply to get a bevel around our table. */ frame = gtk_frame_new (NULL); /* * Here we create the table. We give it the three pieces of * the table we've created, the header, the model, and the * initial layout. It does the rest. */ e_table = e_table_new (e_table_header, e_table_model, INITIAL_SPEC); /* Build the gtk widget hierarchy. */ gtk_container_add (GTK_CONTAINER (frame), e_table); gtk_container_add (GTK_CONTAINER (window), frame); /* Size the initial window. */ gtk_widget_set_usize (window, 300, 200); /* Show it all. */ gtk_widget_show_all (window); } /* This is the main function which just initializes gnome and call our create_table function */ int main (int argc, char *argv []) { gnome_init ("TableExample", "TableExample", argc, argv); e_cursors_init (); gtk_widget_push_visual (gdk_rgb_get_visual ()); gtk_widget_push_colormap (gdk_rgb_get_cmap ()); create_table (); gtk_main (); e_cursors_shutdown (); return 0; }