HildonTimeButton

HildonTimeButton — Button displaying and allowing selection of a time.

Synopsis


#include <hildon/hildon.h>

                    HildonTimeButton;
GtkWidget*          hildon_time_button_new              (HildonSizeType size,
                                                         HildonButtonArrangement arrangement);
GtkWidget*          hildon_time_button_new_step         (HildonSizeType size,
                                                         HildonButtonArrangement arrangement,
                                                         guint minutes_step);
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 and GtkBuildable.

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

GtkWidget*          hildon_time_button_new_step         (HildonSizeType size,
                                                         HildonButtonArrangement arrangement,
                                                         guint minutes_step);

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

size : One of HildonSizeType
arrangement : one of HildonButtonArrangement
minutes_step : step between the minutes in the selector options
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