Hildon Reference Manual | ||||
---|---|---|---|---|
#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);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----HildonButton +----HildonPickerButton +----HildonTimeButton
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.
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
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
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
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