aboutsummaryrefslogtreecommitdiffstats
path: root/widgets
diff options
context:
space:
mode:
authorChris Toshok <toshok@src.gnome.org>2000-04-17 13:53:32 +0800
committerChris Toshok <toshok@src.gnome.org>2000-04-17 13:53:32 +0800
commit832bcdf998ea2b015a9b6904f72bfb3949f1b80a (patch)
tree43af512afb6bb6ef7ca50b3ac3a0d211d928a36c /widgets
parent3f0d6f5cf6914eec8040b569af95898d6e99a0fc (diff)
downloadgsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar.gz
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar.bz2
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar.lz
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar.xz
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.tar.zst
gsoc2013-evolution-832bcdf998ea2b015a9b6904f72bfb3949f1b80a.zip
add table-size-test
* Makefile.am (noinst_PROGRAMS): add table-size-test * .cvsignore: add table-size-test. * e-cell-text.c (ect_ecent): use e_table_model_is_cell_editable instead of E_CELL_EDITABLE. * e-cell-toggle.c (etog_event): same. * e-cell.c (e_cell_init): don't call e_cell_set_editable. that info comes from the model. (e_cell_set_editable): removed function. * e-cell.h: remove the E_CELL_EDITABLE flag. that should be retrieved from the model. also, remove the prototype for e_cell_set_editable. * e-table-size-test.c: new file, for a stress test of sorts, of a large, uneditable e-table. svn path=/trunk/; revision=2468
Diffstat (limited to 'widgets')
-rw-r--r--widgets/e-table/.cvsignore1
-rw-r--r--widgets/e-table/ChangeLog22
-rw-r--r--widgets/e-table/Makefile.am15
-rw-r--r--widgets/e-table/e-cell-text.c4
-rw-r--r--widgets/e-table/e-cell-toggle.c4
-rw-r--r--widgets/e-table/e-cell.c14
-rw-r--r--widgets/e-table/e-cell.h9
-rw-r--r--widgets/e-table/e-table-size-test.c264
-rw-r--r--widgets/table/.cvsignore1
-rw-r--r--widgets/table/e-cell-text.c4
-rw-r--r--widgets/table/e-cell-toggle.c4
-rw-r--r--widgets/table/e-cell.c14
-rw-r--r--widgets/table/e-cell.h9
-rw-r--r--widgets/table/e-table-size-test.c264
14 files changed, 573 insertions, 56 deletions
diff --git a/widgets/e-table/.cvsignore b/widgets/e-table/.cvsignore
index ca61202868..1ee11c15ff 100644
--- a/widgets/e-table/.cvsignore
+++ b/widgets/e-table/.cvsignore
@@ -7,3 +7,4 @@ Makefile.in
table-test
table-example-1
table-example-2
+table-size-test
diff --git a/widgets/e-table/ChangeLog b/widgets/e-table/ChangeLog
index 0fbc9bec55..5e247bf5b5 100644
--- a/widgets/e-table/ChangeLog
+++ b/widgets/e-table/ChangeLog
@@ -1,3 +1,25 @@
+2000-04-17 Chris Toshok <toshok@helixcode.com>
+
+ * Makefile.am (noinst_PROGRAMS): add table-size-test
+
+ * .cvsignore: add table-size-test.
+
+ * e-cell-text.c (ect_ecent): use e_table_model_is_cell_editable
+ instead of E_CELL_EDITABLE.
+
+ * e-cell-toggle.c (etog_event): same.
+
+ * e-cell.c (e_cell_init): don't call e_cell_set_editable. that
+ info comes from the model.
+ (e_cell_set_editable): removed function.
+
+ * e-cell.h: remove the E_CELL_EDITABLE flag. that should be
+ retrieved from the model. also, remove the prototype for
+ e_cell_set_editable.
+
+ * e-table-size-test.c: new file, for a stress test of sorts, of a
+ large, uneditable e-table.
+
2000-04-16 Anders Carlsson <andersca@gnu.org>
* e-table-item.c (eti_event): Propagate mouse wheel events upwards.
diff --git a/widgets/e-table/Makefile.am b/widgets/e-table/Makefile.am
index b5fa084f1a..1ccff682c5 100644
--- a/widgets/e-table/Makefile.am
+++ b/widgets/e-table/Makefile.am
@@ -64,7 +64,7 @@ libetable_a_SOURCES = \
e-table-text-model.h
noinst_PROGRAMS = \
- table-test table-example-1 table-example-2
+ table-test table-example-1 table-example-2 table-size-test
table_test_SOURCES = \
test-table.c \
@@ -80,6 +80,17 @@ table_test_LDADD = \
table_test_LDFLAGS = `gnome-config --libs gdk_pixbuf`
+table_size_test_SOURCES = \
+ e-table-size-test.c
+
+table_size_test_LDADD = \
+ libetable.a \
+ $(EXTRA_GNOME_LIBS) \
+ $(top_builddir)/widgets/e-text/libetext.a \
+ $(top_builddir)/e-util/libeutil.la
+
+table_size_test_LDFLAGS = `gnome-config --libs gdk_pixbuf`
+
table_example_1_SOURCES = \
e-table-example-1.c
@@ -114,4 +125,4 @@ EXTRA_DIST = \
sample.table \
$(icons) \
$(glade_DATA) \
- $(glade_headers) \ No newline at end of file
+ $(glade_headers)
diff --git a/widgets/e-table/e-cell-text.c b/widgets/e-table/e-cell-text.c
index 0649392fc6..3df3434661 100644
--- a/widgets/e-table/e-cell-text.c
+++ b/widgets/e-table/e-cell-text.c
@@ -781,7 +781,7 @@ ect_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
return TRUE;
}
- if ((!edit_display) && E_CELL_IS_EDITABLE (ect)) {
+ if ((!edit_display) && e_table_model_is_cell_editable (ecell_view->e_table_model, view_col, row)) {
e_table_item_enter_edit (text_view->cell_view.e_table_item_view, view_col, row);
ect_edit_select_all (text_view);
edit = text_view->edit;
@@ -812,7 +812,7 @@ ect_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
event->button.x -= 4;
event->button.y -= 1;
if ((!edit_display)
- && E_CELL_IS_EDITABLE (ect)
+ && e_table_model_is_cell_editable (ecell_view->e_table_model, view_col, row)
&& event->type == GDK_BUTTON_RELEASE
&& event->button.button == 1) {
GdkEventButton button = event->button;
diff --git a/widgets/e-table/e-cell-toggle.c b/widgets/e-table/e-cell-toggle.c
index aa07a5c3b8..d620112708 100644
--- a/widgets/e-table/e-cell-toggle.c
+++ b/widgets/e-table/e-cell-toggle.c
@@ -190,14 +190,14 @@ etog_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
switch (event->type){
case GDK_BUTTON_RELEASE:
- if (!E_CELL_IS_EDITABLE (ecell_view->ecell))
+ if (!e_table_model_is_cell_editable(ecell_view->e_table_model, model_col, row))
return FALSE;
etog_set_value (toggle_view, model_col, view_col, row, value + 1);
return TRUE;
case GDK_KEY_PRESS:
- if (!E_CELL_IS_EDITABLE (ecell_view->ecell))
+ if (!e_table_model_is_cell_editable(ecell_view->e_table_model, model_col, row))
return FALSE;
if (event->key.keyval == GDK_space){
diff --git a/widgets/e-table/e-cell.c b/widgets/e-table/e-cell.c
index d038f80b5c..b472b6f6ff 100644
--- a/widgets/e-table/e-cell.c
+++ b/widgets/e-table/e-cell.c
@@ -109,10 +109,6 @@ e_cell_class_init (GtkObjectClass *object_class)
static void
e_cell_init (GtkObject *object)
{
- /*
- * By default we are editable, that is what the old behaviour was
- */
- e_cell_set_editable (E_CELL (object), TRUE);
}
E_MAKE_TYPE(e_cell, "ECell", ECell, e_cell_class_init, e_cell_init, PARENT_TYPE);
@@ -178,13 +174,3 @@ e_cell_leave_edit (ECellView *ecell_view, int model_col, int view_col, int row,
E_CELL_CLASS (GTK_OBJECT (ecell_view->ecell)->klass)->leave_edit (
ecell_view, model_col, view_col, row, edit_context);
}
-
-void
-e_cell_set_editable (ECell *ecell, gboolean editable)
-{
- if (editable)
- GTK_OBJECT (ecell)->flags |= E_CELL_EDITABLE;
- else
- GTK_OBJECT (ecell)->flags &= ~E_CELL_EDITABLE;
-}
-
diff --git a/widgets/e-table/e-cell.h b/widgets/e-table/e-cell.h
index 8098d553f5..8804d2066f 100644
--- a/widgets/e-table/e-cell.h
+++ b/widgets/e-table/e-cell.h
@@ -14,13 +14,6 @@
typedef struct _ECell ECell;
typedef struct _ECellView ECellView;
-/* Object flags for ECells */
-enum {
- E_CELL_EDITABLE = 1 << 4
-};
-
-#define E_CELL_IS_EDITABLE(e) (GTK_OBJECT (e)->flags & E_CELL_EDITABLE)
-
struct _ECell {
GtkObject object;
};
@@ -81,6 +74,4 @@ int e_cell_height (ECellView *ecell_view, int model_col, int view_col,
void *e_cell_enter_edit (ECellView *ecell_view, int model_col, int view_col, int row);
void e_cell_leave_edit (ECellView *ecell_view, int model_col, int view_col, int row, void *edit_context);
-void e_cell_set_editable (ECell *ecell, gboolean editable);
-
#endif /* _E_CELL_H_ */
diff --git a/widgets/e-table/e-table-size-test.c b/widgets/e-table/e-table-size-test.c
new file mode 100644
index 0000000000..c30cd73e2e
--- /dev/null
+++ b/widgets/e-table/e-table-size-test.c
@@ -0,0 +1,264 @@
+/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
+/* This code is GPL. */
+#include <stdio.h>
+#include <string.h>
+#include <gnome.h>
+#include "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 <gdk-pixbuf/gdk-pixbuf.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 "<ETableSpecification> \
+ <columns-shown> \
+ <column> 0 </column> \
+ <column> 4 </column> \
+ <column> 1 </column> \
+ <column> 2 </column> \
+ <column> 3 </column> \
+ </columns-shown> \
+ <grouping> <leaf column=\"1\" ascending=\"1\"/> </grouping> \
+</ETableSpecification>"
+
+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)
+{
+ if (col == 1) return "toshok@helixcode.com";
+ else if (col == 2) return "Chris Toshok";
+ else if (col == 3) return "43 Vicksburg, SF";
+ else if (col == 4) return "415-867-5309";
+}
+
+/* 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 is for when the model is unfrozen. This can mostly
+ be ignored for simple models. */
+static void
+my_thaw (ETableModel *etc, void *data)
+{
+}
+
+/* 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_thaw, 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],
+ 80, 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;
+}
+
diff --git a/widgets/table/.cvsignore b/widgets/table/.cvsignore
index ca61202868..1ee11c15ff 100644
--- a/widgets/table/.cvsignore
+++ b/widgets/table/.cvsignore
@@ -7,3 +7,4 @@ Makefile.in
table-test
table-example-1
table-example-2
+table-size-test
diff --git a/widgets/table/e-cell-text.c b/widgets/table/e-cell-text.c
index 0649392fc6..3df3434661 100644
--- a/widgets/table/e-cell-text.c
+++ b/widgets/table/e-cell-text.c
@@ -781,7 +781,7 @@ ect_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
return TRUE;
}
- if ((!edit_display) && E_CELL_IS_EDITABLE (ect)) {
+ if ((!edit_display) && e_table_model_is_cell_editable (ecell_view->e_table_model, view_col, row)) {
e_table_item_enter_edit (text_view->cell_view.e_table_item_view, view_col, row);
ect_edit_select_all (text_view);
edit = text_view->edit;
@@ -812,7 +812,7 @@ ect_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
event->button.x -= 4;
event->button.y -= 1;
if ((!edit_display)
- && E_CELL_IS_EDITABLE (ect)
+ && e_table_model_is_cell_editable (ecell_view->e_table_model, view_col, row)
&& event->type == GDK_BUTTON_RELEASE
&& event->button.button == 1) {
GdkEventButton button = event->button;
diff --git a/widgets/table/e-cell-toggle.c b/widgets/table/e-cell-toggle.c
index aa07a5c3b8..d620112708 100644
--- a/widgets/table/e-cell-toggle.c
+++ b/widgets/table/e-cell-toggle.c
@@ -190,14 +190,14 @@ etog_event (ECellView *ecell_view, GdkEvent *event, int model_col, int view_col,
switch (event->type){
case GDK_BUTTON_RELEASE:
- if (!E_CELL_IS_EDITABLE (ecell_view->ecell))
+ if (!e_table_model_is_cell_editable(ecell_view->e_table_model, model_col, row))
return FALSE;
etog_set_value (toggle_view, model_col, view_col, row, value + 1);
return TRUE;
case GDK_KEY_PRESS:
- if (!E_CELL_IS_EDITABLE (ecell_view->ecell))
+ if (!e_table_model_is_cell_editable(ecell_view->e_table_model, model_col, row))
return FALSE;
if (event->key.keyval == GDK_space){
diff --git a/widgets/table/e-cell.c b/widgets/table/e-cell.c
index d038f80b5c..b472b6f6ff 100644
--- a/widgets/table/e-cell.c
+++ b/widgets/table/e-cell.c
@@ -109,10 +109,6 @@ e_cell_class_init (GtkObjectClass *object_class)
static void
e_cell_init (GtkObject *object)
{
- /*
- * By default we are editable, that is what the old behaviour was
- */
- e_cell_set_editable (E_CELL (object), TRUE);
}
E_MAKE_TYPE(e_cell, "ECell", ECell, e_cell_class_init, e_cell_init, PARENT_TYPE);
@@ -178,13 +174,3 @@ e_cell_leave_edit (ECellView *ecell_view, int model_col, int view_col, int row,
E_CELL_CLASS (GTK_OBJECT (ecell_view->ecell)->klass)->leave_edit (
ecell_view, model_col, view_col, row, edit_context);
}
-
-void
-e_cell_set_editable (ECell *ecell, gboolean editable)
-{
- if (editable)
- GTK_OBJECT (ecell)->flags |= E_CELL_EDITABLE;
- else
- GTK_OBJECT (ecell)->flags &= ~E_CELL_EDITABLE;
-}
-
diff --git a/widgets/table/e-cell.h b/widgets/table/e-cell.h
index 8098d553f5..8804d2066f 100644
--- a/widgets/table/e-cell.h
+++ b/widgets/table/e-cell.h
@@ -14,13 +14,6 @@
typedef struct _ECell ECell;
typedef struct _ECellView ECellView;
-/* Object flags for ECells */
-enum {
- E_CELL_EDITABLE = 1 << 4
-};
-
-#define E_CELL_IS_EDITABLE(e) (GTK_OBJECT (e)->flags & E_CELL_EDITABLE)
-
struct _ECell {
GtkObject object;
};
@@ -81,6 +74,4 @@ int e_cell_height (ECellView *ecell_view, int model_col, int view_col,
void *e_cell_enter_edit (ECellView *ecell_view, int model_col, int view_col, int row);
void e_cell_leave_edit (ECellView *ecell_view, int model_col, int view_col, int row, void *edit_context);
-void e_cell_set_editable (ECell *ecell, gboolean editable);
-
#endif /* _E_CELL_H_ */
diff --git a/widgets/table/e-table-size-test.c b/widgets/table/e-table-size-test.c
new file mode 100644
index 0000000000..c30cd73e2e
--- /dev/null
+++ b/widgets/table/e-table-size-test.c
@@ -0,0 +1,264 @@
+/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
+/* This code is GPL. */
+#include <stdio.h>
+#include <string.h>
+#include <gnome.h>
+#include "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 <gdk-pixbuf/gdk-pixbuf.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 "<ETableSpecification> \
+ <columns-shown> \
+ <column> 0 </column> \
+ <column> 4 </column> \
+ <column> 1 </column> \
+ <column> 2 </column> \
+ <column> 3 </column> \
+ </columns-shown> \
+ <grouping> <leaf column=\"1\" ascending=\"1\"/> </grouping> \
+</ETableSpecification>"
+
+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)
+{
+ if (col == 1) return "toshok@helixcode.com";
+ else if (col == 2) return "Chris Toshok";
+ else if (col == 3) return "43 Vicksburg, SF";
+ else if (col == 4) return "415-867-5309";
+}
+
+/* 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 is for when the model is unfrozen. This can mostly
+ be ignored for simple models. */
+static void
+my_thaw (ETableModel *etc, void *data)
+{
+}
+
+/* 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_thaw, 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],
+ 80, 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;
+}
+