## ECellDate

ECellDate

## Synopsis

    struct              ECellDate;
    ECell *             e_cell_date_new                     (const gchar *fontname,
                                                             GtkJustification justify);
    void                e_cell_date_set_format_component    (ECellDate *ecd,
                                                             const gchar *fmt_component);

## Object Hierarchy

      GObject
       +----ECell
             +----ECellText
                   +----ECellDate

## Description

## Details

### struct ECellDate

    struct ECellDate;

### e_cell_date_new ()

    ECell *             e_cell_date_new                     (const gchar *fontname,
                                                             GtkJustification justify);

Creates a new ECell renderer that can be used to render dates that that come from the model. The value returned from the model is interpreted as being a time_t.

The ECellDate object support a large set of properties that can be configured through the Gtk argument system and allows the user to have a finer control of the way the string is displayed. The arguments supported allow the control of strikeout, bold, color and a date filter.

The arguments "strikeout_column", "underline_column", "bold_column" and "color_column" set and return an integer that points to a column in the model that controls these settings. So controlling the way things are rendered is achieved by having special columns in the model that will be used to flag whether the date should be rendered with strikeout, underline, or bolded. In the case of the "color_column" argument, the column in the model is expected to have a string that can be parsed by `gdk_color_parse()`.

`fontname` : | font to be used to render on the screen
`justify` : | Justification of the string in the cell.
Returns : | an ECell object that can be used to render dates.

### e_cell_date_set_format_component ()

    void                e_cell_date_set_format_component    (ECellDate *ecd,
                                                             const gchar *fmt_component);