HildonTimeButton

HildonTimeButton — Button displaying and allowing selection of a time.

Synopsis

                    HildonTimeButton;
GtkWidget *         hildon_time_button_new              (HildonSizeType size,
                                                         HildonButtonArrangement arrangement);
void                hildon_time_button_get_time         (HildonTimeButton *button,
                                                         guint *hours,
                                                         guint *minutes);
void                hildon_time_button_set_time         (HildonTimeButton *button,
                                                         guint hours,
                                                         guint minutes);

Object Hierarchy

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

Implemented Interfaces

HildonTimeButton implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Description

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

Details

HildonTimeButton

typedef struct _HildonTimeButton HildonTimeButton;


hildon_time_button_new ()

GtkWidget *         hildon_time_button_new              (HildonSizeType size,
                                                         HildonButtonArrangement arrangement);

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

size :

One of HildonSizeType

arrangement :

one of HildonButtonArrangement

Returns :

a new HildonTimeButton

Since 2.2


hildon_time_button_get_time ()

void                hildon_time_button_get_time         (HildonTimeButton *button,
                                                         guint *hours,
                                                         guint *minutes);

Retrieves the time from button.

button :

a HildonTimeButton

hours :

return location for the hours of the time selected

minutes :

return location for the minutes of the time selected

Since 2.2


hildon_time_button_set_time ()

void                hildon_time_button_set_time         (HildonTimeButton *button,
                                                         guint hours,
                                                         guint minutes);

Sets the time to be displayed in button. This time will be selected by default on the HildonTimeSelector.

button :

a HildonTimeButton

hours :

the hours to be set

minutes :

the time to be set

Since 2.2

See Also

#HildonPickerButton, HildonDateButton