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, GtkBuildable and GtkOrientable.

Description

HildonDateSelector is a date widget, equivalent to hildon-calendar, but with a multi-column approach

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, too keep this API more similar to the previously existing hildon-calendar 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, too keep this API more similar to the previously existing hildon-calendar 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