GNOME UI Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GnomeDateEdit

## Name

GnomeDateEdit --

## Synopsis

    enum        GnomeDateEditFlags;
    struct      GnomeDateEditPrivate;
    GtkWidget*  gnome_date_edit_new             (time_t the_time,
                                                 gboolean show_time,
                                                 gboolean use_24_format);
    GtkWidget*  gnome_date_edit_new_flags       (time_t the_time,
                                                 GnomeDateEditFlags flags);
    void        gnome_date_edit_construct       (GnomeDateEdit *gde,
                                                 time_t the_time,
                                                 GnomeDateEditFlags flags);
    void        gnome_date_edit_set_time        (GnomeDateEdit *gde,
                                                 time_t the_time);
    time_t      gnome_date_edit_get_time        (GnomeDateEdit *gde);
    void        gnome_date_edit_set_popup_range (GnomeDateEdit *gde,
                                                 int low_hour,
                                                 int up_hour);
    void        gnome_date_edit_set_flags       (GnomeDateEdit *gde,
                                                 GnomeDateEditFlags flags);
    int         gnome_date_edit_get_flags       (GnomeDateEdit *gde);
    time_t      gnome_date_edit_get_initial_time
                                                (GnomeDateEdit *gde);
    time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);

## Description

## Details

### enum GnomeDateEditFlags

    typedef enum {
    	GNOME_DATE_EDIT_SHOW_TIME             = 1 << 0,
    	GNOME_DATE_EDIT_24_HR                 = 1 << 1,
    	GNOME_DATE_EDIT_WEEK_STARTS_ON_MONDAY = 1 << 2
    } GnomeDateEditFlags;

### struct GnomeDateEditPrivate

    struct GnomeDateEditPrivate;

### gnome_date_edit_new ()

    GtkWidget*  gnome_date_edit_new             (time_t the_time,
                                                 gboolean show_time,
                                                 gboolean use_24_format);

Creates a new GnomeDateEdit widget which can be used to provide an easy to use way for entering dates and times. If `the_time` is 0 then current time is used.

`the_time` : | date and time to be displayed on the widget
`show_time` : | whether time should be displayed
`use_24_format` : | whether 24-hour format is desired for the time display.
Returns : | a new GnomeDateEdit widget.

### gnome_date_edit_new_flags ()

    GtkWidget*  gnome_date_edit_new_flags       (time_t the_time,
                                                 GnomeDateEditFlags flags);

Creates a new GnomeDateEdit widget with the specified flags. If `the_time` is 0 then current time is used.

`the_time` : | The initial time for the date editor.
`flags` : | A bitmask of GnomeDateEditFlags values.
Returns : | the newly-created date editor widget.

### gnome_date_edit_construct ()

    void        gnome_date_edit_construct       (GnomeDateEdit *gde,
                                                 time_t the_time,
                                                 GnomeDateEditFlags flags);

For language bindings and subclassing only

`gde` : | The GnomeDateEdit object to construct
`the_time` : | The initial time for the date editor.
`flags` : | A bitmask of GnomeDateEditFlags values.

### gnome_date_edit_set_time ()

    void        gnome_date_edit_set_time        (GnomeDateEdit *gde,
                                                 time_t the_time);

Changes the displayed date and time in the GnomeDateEdit widget to be the one represented by `the_time`. If `the_time` is 0 then current time is used.

`gde` : | the GnomeDateEdit widget
`the_time` : | The time and date that should be set on the widget

### gnome_date_edit_get_time ()

    time_t      gnome_date_edit_get_time        (GnomeDateEdit *gde);

`gde` : | The GnomeDateEdit widget
Returns : | the time entered in the GnomeDateEdit widget

### gnome_date_edit_set_popup_range ()

    void        gnome_date_edit_set_popup_range (GnomeDateEdit *gde,
                                                 int low_hour,
                                                 int up_hour);

Sets the range of times that will be provide by the time popup selectors.

`gde` : | The GnomeDateEdit widget
`low_hour` : | low boundary for the time-range display popup.
`up_hour` : | upper boundary for the time-range display popup.

### gnome_date_edit_set_flags ()

    void        gnome_date_edit_set_flags       (GnomeDateEdit *gde,
                                                 GnomeDateEditFlags flags);

Changes the display flags on an existing date editor widget.

`gde` : | The date editor widget whose flags should be changed.
`flags` : | The new bitmask of GnomeDateEditFlags values.

### gnome_date_edit_get_flags ()

    int         gnome_date_edit_get_flags       (GnomeDateEdit *gde);

Queries the display flags on a date editor widget.

`gde` : | The date editor whose flags should be queried.
Returns : | The current display flags for the specified date editor widget.

### gnome_date_edit_get_initial_time ()

    time_t      gnome_date_edit_get_initial_time
                                                (GnomeDateEdit *gde);

Queries the initial time that was set using the gnome_date_edit_set_time or during creation

`gde` : | The date editor whose initial time should be queried
Returns : | The initial time in seconds (standard time_t format)

### gnome_date_edit_get_date ()

    time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);

Deprecated, use gnome_date_edit_get_time

`gde` : | The GnomeDateEdit widget
Returns : |

<<< Previous Page | Home | Up | Next Page >>>
GnomeColorPicker | GnomeDruidPageEdge