2008-11-25 Alberto Garcia <agarcia@igalia.com>

[hildon] / src / hildon-time-selector.c

diff --git a/src/hildon-time-selector.c b/src/hildon-time-selector.c
index bc5a485..e28a4fc 100644 (file)
--- a/src/hildon-time-selector.c
+++ b/src/hildon-time-selector.c
@@ -131,6 +131,8 @@ hildon_time_selector_class_init (HildonTimeSelectorClass * class)
 static void
 hildon_time_selector_init (HildonTimeSelector * selector)
 {
+  HildonTouchSelectorColumn *column = NULL;
+
   selector->priv = HILDON_TIME_SELECTOR_GET_PRIVATE (selector);
 
   GTK_WIDGET_SET_FLAGS (GTK_WIDGET (selector), GTK_NO_WINDOW);
@@ -147,11 +149,13 @@ hildon_time_selector_init (HildonTimeSelector * selector)
   selector->priv->hours_model = _create_hours_model (selector);
   selector->priv->minutes_model = _create_minutes_model (selector);
 
-  hildon_touch_selector_append_text_column (HILDON_TOUCH_SELECTOR (selector),
-                                            selector->priv->hours_model, TRUE);
+  column = hildon_touch_selector_append_text_column (HILDON_TOUCH_SELECTOR (selector),
+                                                     selector->priv->hours_model, TRUE);
+  g_object_set (column, "text-column", 0, NULL);
 
-  hildon_touch_selector_append_text_column (HILDON_TOUCH_SELECTOR (selector),
-                                            selector->priv->minutes_model, TRUE);
+  column = hildon_touch_selector_append_text_column (HILDON_TOUCH_SELECTOR (selector),
+                                                     selector->priv->minutes_model, TRUE);
+  g_object_set (column, "text-column", 0, NULL);
 
   if (selector->priv->ampm_format) {
     selector->priv->ampm_model = _create_ampm_model (selector);
@@ -389,10 +393,18 @@ hildon_time_selector_new ()
   return g_object_new (HILDON_TYPE_TIME_SELECTOR, NULL);
 }
 
-/*
- * hours (0-23)
- * minutes (0-59)
- */
+/**
+ * hildon_time_selector_set_time
+ * @selector: the #HildonTimeSelector
+ * @hours:  the current hour (0-23)
+ * @minutes: the current minute (0-59)
+ *
+ * Sets the current active hour on the #HildonTimeSelector widget
+ *
+ * The format of the hours acceptes is always 24h format, with a range
+ * (0-23):(0-59).
+ *
+ **/
 gboolean
 hildon_time_selector_set_time (HildonTimeSelector * selector,
                                guint hours, guint minutes)
@@ -424,6 +436,18 @@ hildon_time_selector_set_time (HildonTimeSelector * selector,
   return TRUE;
 }
 
+/**
+ * hildon_time_selector_get_time
+ * @selector: the #HildonTimeSelector
+ * @hours:  to set the current hour (0-23)
+ * @minutes: to set the current minute (0-59)
+ *
+ * Gets the current active hour on the #HildonTimeSelector widget. Both @year
+ * and @minutes can be NULL.
+ *
+ * This method returns the date always in 24h format, with a range (0-23):(0-59)
+ *
+ **/
 void
 hildon_time_selector_get_time (HildonTimeSelector * selector,
                                guint * hours, guint * minutes)