ETableCol: Evolution Utilities Reference Manual

## ETableCol ETableCol |

## Functions

ETableCol * | e_table_col_new ()

## Types and Values

struct | ETableCol

## Object Hierarchy

        GObject
        ╰── ETableCol

## Description

## Functions

### e_table_col_new ()

    ETableCol *
    e_table_col_new (ETableColumnSpecification *spec,
                     const gchar *text,
                     const gchar *icon_name,
                     ECell *ecell,
                     GCompareDataFunc compare);

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()`.

#### Parameters

spec | an ETableColumnSpecification |
text | a title for this column |
icon_name | name of the icon to be used for the header, or `NULL` |
ecell | the renderer to be used for this column |
compare | comparision function for the elements stored in this column |

#### Returns

the newly created ETableCol object.

## Types and Values

### struct ETableCol

    struct ETableCol;