Next: , Previous: GnomeClient, Up: Top


4 GnomeDateEdit

4.1 Overview

4.2 Usage

— Class: <gnome-date-edit>

Derives from <gtk-hbox>.

This class defines the following slots:

time
The time currently selected
dateedit-flags
Flags for how DateEdit looks
lower-hour
Lower hour in the time popup selector
upper-hour
Upper hour in the time popup selector
initial-time
The initial time
— Signal on <gnome-date-edit>: time-changed
— Signal on <gnome-date-edit>: date-changed
— Function: gnome-date-edit-new (the_time long) (show_time bool) (use_24_format bool) ⇒  (ret <gtk-widget>)

Creates a new <gnome-date-edit> 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.
ret
a new <gnome-date-edit> widget.
— Function: gnome-date-edit-new-flags (the_time long) (flags <gnome-date-edit-flags>) ⇒  (ret <gtk-widget>)

Creates a new <gnome-date-edit> 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.
ret
the newly-created date editor widget.
— Function: gnome-date-edit-construct (self <gnome-date-edit>) (the_time long) (flags <gnome-date-edit-flags>)
— Method: construct

For language bindings and subclassing only

gde
The <gnome-date-edit> object to construct
the-time
The initial time for the date editor.
flags
A bitmask of GnomeDateEditFlags values.
— Function: gnome-date-edit-set-time (self <gnome-date-edit>) (the_time long)
— Method: set-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
— Function: gnome-date-edit-get-time (self <gnome-date-edit>) ⇒  (ret long)
— Method: get-time
gde
The GnomeDateEdit widget
ret
the time entered in the GnomeDateEdit widget
— Function: gnome-date-edit-set-popup-range (self <gnome-date-edit>) (low_hour int) (up_hour int)
— Method: set-popup-range

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.
— Function: gnome-date-edit-set-flags (self <gnome-date-edit>) (flags <gnome-date-edit-flags>)
— Method: set-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.
— Function: gnome-date-edit-get-flags (self <gnome-date-edit>) ⇒  (ret int)
— Method: get-flags

Queries the display flags on a date editor widget.

gde
The date editor whose flags should be queried.
ret
The current display flags for the specified date editor widget.
— Function: gnome-date-edit-get-initial-time (self <gnome-date-edit>) ⇒  (ret long)
— Method: get-initial-time

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
ret
The initial time in seconds (standard time_t format)