|  |  |  | GNOME UI Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <libgnomeui/libgnomeui.h> enum GnomeDateEditFlags; struct GnomeDateEdit; 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);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----GnomeDateEdit
GnomeDateEdit implements AtkImplementorIface, GtkBuildable and GtkOrientable.
"dateedit-flags" GnomeDateEditFlags : Read / Write "initial-time" gulong : Read / Write "lower-hour" gint : Read / Write "time" gulong : Read / Write "upper-hour" gint : Read / Write
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,
	GNOME_DATE_EDIT_DISPLAY_SECONDS       = 1 << 3
} GnomeDateEditFlags;
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.
| 
 | date and time to be displayed on the widget | 
| 
 | whether time should be displayed | 
| 
 | whether 24-hour format is desired for the time display. | 
| Returns : | a new GnomeDateEdit widget. | 
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 initial time for the date editor. | 
| 
 | A bitmask of GnomeDateEditFlags values. | 
| Returns : | the newly-created date editor widget. | 
void gnome_date_edit_construct (GnomeDateEdit *gde,time_t the_time,GnomeDateEditFlags flags);
For language bindings and subclassing only
| 
 | The GnomeDateEdit object to construct | 
| 
 | The initial time for the date editor. | 
| 
 | A bitmask of GnomeDateEditFlags values. | 
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.
| 
 | the GnomeDateEdit widget | 
| 
 | The time and date that should be set on the widget | 
time_t              gnome_date_edit_get_time            (GnomeDateEdit *gde);
| 
 | The GnomeDateEdit widget | 
| Returns : | the time entered in the GnomeDateEdit widget | 
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.
| 
 | The GnomeDateEdit widget | 
| 
 | low boundary for the time-range display popup. | 
| 
 | upper boundary for the time-range display popup. | 
void gnome_date_edit_set_flags (GnomeDateEdit *gde,GnomeDateEditFlags flags);
Changes the display flags on an existing date editor widget.
| 
 | The date editor widget whose flags should be changed. | 
| 
 | The new bitmask of GnomeDateEditFlags values. | 
int                 gnome_date_edit_get_flags           (GnomeDateEdit *gde);
Queries the display flags on a date editor widget.
| 
 | The date editor whose flags should be queried. | 
| Returns : | The current display flags for the specified date editor widget. | 
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
| 
 | The date editor whose initial time should be queried | 
| Returns : | The initial time in seconds (standard time_t format) | 
time_t              gnome_date_edit_get_date            (GnomeDateEdit *gde);
gnome_date_edit_get_date is deprecated and should not be used in newly-written code.
Deprecated, use gnome_date_edit_get_time
| 
 | The GnomeDateEdit widget | 
"dateedit-flags" property"dateedit-flags" GnomeDateEditFlags : Read / Write
Flags for how DateEdit looks.
Default value: GNOME_DATE_EDIT_SHOW_TIME
"lower-hour" property"lower-hour" gint : Read / Write
Lower hour in the time popup selector.
Allowed values: [0,24]
Default value: 7
"upper-hour" property"upper-hour" gint : Read / Write
Upper hour in the time popup selector.
Allowed values: [0,24]
Default value: 19
"date-changed" signalvoid                user_function                      (GnomeDateEdit *dateedit,
                                                        gpointer       user_data)      : Run First
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"time-changed" signalvoid                user_function                      (GnomeDateEdit *dateedit,
                                                        gpointer       user_data)      : Run First
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. |