Gnome User Interface Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GnomeDateEdit

## Name

GnomeDateEdit -- Date and time entry widget.

## Synopsis

    #include <gnome.h>

    struct      GnomeDateEdit;
    GtkWidget*  gnome_date_edit_new             (time_t the_time,
                                                 int show_time,
                                                 int use_24_format);
    void        gnome_date_edit_set_time        (GnomeDateEdit *gde,
                                                 time_t the_time);
    void        gnome_date_edit_set_popup_range (GnomeDateEdit *gde,
                                                 int low_hour,
                                                 int up_hour);
    time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer
                   +----GtkBox
                         +----GtkHBox
                               +----GnomeDateEdit

## Description

The GnomeDateEdit widget provides a way to enter dates and times with a helper calendar to let the user select the date.

## Details

### struct GnomeDateEdit

    struct GnomeDateEdit;

### gnome_date_edit_new ()

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

Creates a new GnomeDateEdit widget which can be used to provide an easy to use way for entering dates and times.

`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 GnomeDateEdit widget.

### 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`.

`gde` : | the GnomeDateEdit widget
`the_time` : | The time and date that should be set on the 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_get_date ()

    time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);

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

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