Evolution Utilities Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
Synopsis
struct ETableCol; ETableCol * e_table_col_new (gint col_idx
,const gchar *text
,const gchar *icon_name
,gdouble expansion
,gint min_width
,ECell *ecell
,GCompareDataFunc compare
,gboolean resizable
,gboolean disabled
,gint priority
);
Details
e_table_col_new ()
ETableCol * e_table_col_new (gint col_idx
,const gchar *text
,const gchar *icon_name
,gdouble expansion
,gint min_width
,ECell *ecell
,GCompareDataFunc compare
,gboolean resizable
,gboolean disabled
,gint priority
);
The ETableCol represents a column to be used inside an ETable. The ETableCol objects are inserted inside an ETableHeader (which is just a collection of ETableCols). The ETableHeader is the definition of the order in which columns are shown to the user.
The text
argument is the the text that will be shown as a header to the
user. col_idx
reflects where the data for this ETableCol object will
be fetch from an ETableModel. So even if the user changes the order
of the columns being viewed (the ETableCols in the ETableHeader), the
column will always point to the same column inside the ETableModel.
The ecell
argument is an ECell object that needs to know how to
render the data in the ETableModel for this specific row.
Data passed to compare
can be (if not NULL
) a cmp_cache, which
can be accessed by e_table_sorting_utils_add_to_cmp_cache()
and
e_table_sorting_utils_lookup_cmp_cache()
.
|
the column we represent in the model |
|
a title for this column |
|
name of the icon to be used for the header, or NULL
|
|
FIXME |
|
minimum width in pixels for this column |
|
the renderer to be used for this column |
|
comparision function for the elements stored in this column |
|
whether the column can be resized interactively by the user |
|
FIXME |
Returns : |
the newly created ETableCol object. |