HildonDateSelector

HildonDateSelector — A widget to select the current date.

Synopsis

                    HildonDateSelector;
GtkWidget*          hildon_date_selector_new            (void);
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);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----HildonTouchSelector
                                             +----HildonDateSelector

Implemented Interfaces

HildonDateSelector implements AtkImplementorIface and GtkBuildable.

Properties

  "max-year"                 gint                  : Read / Write / Construct Only
  "min-year"                 gint                  : Read / Write / Construct Only

Description

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().

Details

HildonDateSelector

typedef struct _HildonDateSelector HildonDateSelector;


hildon_date_selector_new ()

GtkWidget*          hildon_date_selector_new            (void);

Creates a new HildonDateSelector

Returns : a new HildonDateSelector

Since 2.2


hildon_date_selector_select_month ()

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


hildon_date_selector_select_day ()

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 (1-31, 1-30, 1-29, 1-28) depends on the month

Since 2.2


hildon_date_selector_select_current_date ()

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 (0-11)
day : the current day (1-31, 1-30, 1-29, 1-28) depends on the month
Returns : TRUE on success, FALSE otherwise

Since 2.2


hildon_date_selector_get_date ()

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 : to set the current year
month : to set the current month (0-11)
day : to the current day (1-31, 1-30, 1-29, 1-28) depends on the month

Since 2.2

Property Details

The "max-year" property

  "max-year"                 gint                  : Read / Write / Construct Only

The maximum available year in the selector.

Allowed values: [1900,2100]

Default value: 2037


The "min-year" property

  "min-year"                 gint                  : Read / Write / Construct Only

The minimum available year in the selector.

Allowed values: [1900,2100]

Default value: 1970