HildonDateButton

HildonDateButton — Button displaying and allowing selection of a date.

Synopsis

                    HildonDateButton;
GtkWidget*          hildon_date_button_new              (HildonSizeType size,
                                                         HildonButtonArrangement arrangement);
void                hildon_date_button_get_date         (HildonDateButton *button,
                                                         guint *year,
                                                         guint *month,
                                                         guint *day);
void                hildon_date_button_set_date         (HildonDateButton *button,
                                                         guint year,
                                                         guint month,
                                                         guint day);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkButton
                                       +----HildonButton
                                             +----HildonPickerButton
                                                   +----HildonDateButton

Implemented Interfaces

HildonDateButton implements AtkImplementorIface and GtkBuildable.

Description

HildonDateButton is a widget that shows a text label and a date, and allows the user to select a different date. Visually, it's a button that, once clicked, presents a HildonPickerDialog containing a HildonDateSelector. Once the user selects a different date from the selector, this will be shown in the button.

Details

HildonDateButton

typedef struct _HildonDateButton HildonDateButton;


hildon_date_button_new ()

GtkWidget*          hildon_date_button_new              (HildonSizeType size,
                                                         HildonButtonArrangement arrangement);

Creates a new HildonDateButton. See hildon_button_new() for details on the parameters.

size : One of HildonSizeType
arrangement : one of HildonButtonArrangement
Returns : a new HildonDateButton

hildon_date_button_get_date ()

void                hildon_date_button_get_date         (HildonDateButton *button,
                                                         guint *year,
                                                         guint *month,
                                                         guint *day);

Retrieves currently selected date from button.

button : a HildonDateButton
year : return location for the selected year
month : return location for the selected month
day : return location for the selected day

hildon_date_button_set_date ()

void                hildon_date_button_set_date         (HildonDateButton *button,
                                                         guint year,
                                                         guint month,
                                                         guint day);

Sets the date in button. The date set will be displayed and will be the default selected option on the shown HildonDateSelector.

button : a HildonDateButton
year : the year to set.
month : the month number to set.
day : the day of the month to set.

See Also

HildonPickerButton, HildonTimeButton