![]() |
![]() |
![]() |
Hildon Reference Manual | ![]() |
---|---|---|---|---|
HildonDateSelector; GtkWidget* hildon_date_selector_new (void); GtkWidget* hildon_date_selector_new_with_year_range (gint min_year, gint max_year); gboolean hildon_date_selector_select_month (HildonDateSelector *selector, guint month, guint year); void hildon_date_selector_select_day (HildonDateSelector *selector, guint day); gboolean hildon_date_selector_select_current_date (HildonDateSelector *selector, guint year, guint month, guint day); void hildon_date_selector_get_date (HildonDateSelector *selector, guint *year, guint *month, guint *day);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----HildonTouchSelector +----HildonDateSelector
"max-year" gint : Read / Write / Construct Only "min-year" gint : Read / Write / Construct Only
HildonDateSelector is a date widget with multiple columns. Users can choose a date by selecting values in the day, month and year columns.
The currently selected month and year can be altered with
hildon_date_selector_select_month()
. The day can be selected from
the active month using hildon_date_selector_select_day()
.
GtkWidget* hildon_date_selector_new (void);
Creates a new HildonDateSelector
Returns : | a new HildonDateSelector |
Since 2.2
GtkWidget* hildon_date_selector_new_with_year_range (gint min_year, gint max_year);
Creates a new HildonDateSelector with a specific year range.
If min_year
or max_year
are set to -1, then the default
upper or lower bound will be used, respectively.
min_year : |
the minimum available year or -1 to ignore |
max_year : |
the maximum available year or -1 to ignore |
Returns : | a new HildonDateSelector |
Since 2.2
gboolean hildon_date_selector_select_month (HildonDateSelector *selector, guint month, guint year);
Modify the current month and year on the current active date
Utility function to keep this API similar to the previously existing HildonCalendar widget.
selector : |
the HildonDateSelector |
month : |
the current month (0-11) |
year : |
the current year |
Returns : | TRUE on success, FALSE otherwise
|
Since 2.2
void hildon_date_selector_select_day (HildonDateSelector *selector, guint day);
Modify the current day on the current active date
Utility function to keep this API similar to the previously existing HildonCalendar widget.
selector : |
the HildonDateSelector |
day : |
the current day (between 1 and 31) |
Since 2.2
gboolean hildon_date_selector_select_current_date (HildonDateSelector *selector, guint year, guint month, guint day);
Sets the current active date on the HildonDateSelector widget
selector : |
the HildonDateSelector |
year : |
the current year |
month : |
the current month (between 0 and 11) |
day : |
the current day (between 1 and 31) |
Returns : | TRUE on success, FALSE otherwise
|
Since 2.2
void hildon_date_selector_get_date (HildonDateSelector *selector, guint *year, guint *month, guint *day);
Gets the current active date on the HildonDateSelector widget
selector : |
the HildonDateSelector |
year : |
location of the current year, or NULL |
month : |
location of the current month (between 0 and 11), or NULL |
day : |
location of the current day (between 1 and 31), or NULL |
Since 2.2
"max-year"
property"max-year" gint : Read / Write / Construct Only
The maximum available year in the selector.
Allowed values: [1900,2100]
Default value: 2037
"min-year"
property"min-year" gint : Read / Write / Construct Only
The minimum available year in the selector.
Allowed values: [1900,2100]
Default value: 1970