2008-12-09 Claudio Saavedra <csaavedra@igalia.com>
[hildon] / src / hildon-date-button.c
1 /*
2  * This file is a part of hildon
3  *
4  * Copyright (C) 2008 Nokia Corporation, all rights reserved.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU Lesser Public License as published by
8  * the Free Software Foundation; version 2 of the license.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU Lesser Public License for more details.
14  *
15  */
16
17 #include "hildon-date-button.h"
18 #include "hildon-date-selector.h"
19 #include "hildon-touch-selector.h"
20
21 /**
22  * SECTION:hildon-date-button
23  * @Short_Description: Button displaying and allowing selection of a date.
24  * @See_Also: #HildonPickerButton, #HildonTimeButton
25  *
26  * #HildonDateButton is a widget that shows a text label and a date, and allows
27  * the user to select a different date. Visually, it's a button that, once clicked,
28  * presents a #HildonPickerDialog containing a #HildonDateSelector. Once the user selects
29  * a different date from the selector, this will be shown in the button.
30  */
31
32 G_DEFINE_TYPE (HildonDateButton, hildon_date_button, HILDON_TYPE_PICKER_BUTTON)
33
34 #if 0
35 #define GET_PRIVATE(o)                                                  \
36   (G_TYPE_INSTANCE_GET_PRIVATE ((o), HILDON_TYPE_DATE_BUTTON, HildonDateButtonPrivate))
37
38 typedef struct _HildonDateButtonPrivate HildonDateButtonPrivate;
39
40 struct _HildonDateButtonPrivate
41 {
42 };
43 #endif
44
45 #if 0
46 static void
47 hildon_date_button_get_property (GObject * object, guint property_id,
48                                  GValue * value, GParamSpec * pspec)
49 {
50   switch (property_id) {
51   default:
52     G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
53   }
54 }
55
56 static void
57 hildon_date_button_set_property (GObject * object, guint property_id,
58                                  const GValue * value, GParamSpec * pspec)
59 {
60   switch (property_id) {
61   default:
62     G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
63   }
64 }
65 #endif
66
67 static void
68 hildon_date_button_class_init (HildonDateButtonClass * klass)
69 {
70 #if 0
71   GObjectClass *object_class = G_OBJECT_CLASS (klass);
72
73   g_type_class_add_private (klass, sizeof (HildonDateButtonPrivate));
74
75   object_class->get_property = hildon_date_button_get_property;
76   object_class->set_property = hildon_date_button_set_property;
77 #endif
78 }
79
80 static void
81 hildon_date_button_init (HildonDateButton * self)
82 {
83   GtkWidget *date_selector;
84
85   date_selector = hildon_date_selector_new ();
86
87   hildon_picker_button_set_selector (HILDON_PICKER_BUTTON (self),
88                                      HILDON_TOUCH_SELECTOR (date_selector));
89 }
90
91 /**
92  * hildon_date_button_new:
93  * @size: One of #HildonSizeType
94  * @arrangement: one of #HildonButtonArrangement
95  *
96  * Creates a new #HildonDateButton. See hildon_button_new() for details on the
97  * parameters.
98  *
99  * Returns: a new #HildonDateButton
100  **/
101 GtkWidget *
102 hildon_date_button_new (HildonSizeType          size,
103                         HildonButtonArrangement arrangement)
104 {
105   return g_object_new (HILDON_TYPE_DATE_BUTTON,
106                        "title", "Date",
107                        "arrangement", arrangement,
108                        "size", size,
109                        NULL);
110 }
111
112 /**
113  * hildon_date_button_get_date:
114  * @button: a #HildonDateButton
115  * @year: return location for the selected year
116  * @month: return location for the selected month
117  * @day: return location for the selected day
118  *
119  * Retrieves currently selected date from @button.
120  **/
121 void
122 hildon_date_button_get_date (HildonDateButton * button,
123                              guint * year, guint * month, guint * day)
124 {
125   HildonTouchSelector *selector;
126
127   g_return_if_fail (HILDON_IS_DATE_BUTTON (button));
128
129   selector = hildon_picker_button_get_selector (HILDON_PICKER_BUTTON (button));
130
131   hildon_date_selector_get_date (HILDON_DATE_SELECTOR (selector), year, month, day);
132 }
133
134 /**
135  * hildon_date_button_set_date:
136  * @button: a #HildonDateButton
137  * @year: the year to set.
138  * @month: the month number to set.
139  * @day: the day of the month to set.
140  *
141  * Sets the date in @button. The date set will be displayed
142  * and will be the default selected option on the shown #HildonDateSelector.
143  *
144  **/
145 void
146 hildon_date_button_set_date (HildonDateButton * button,
147                              guint year, guint month, guint day)
148 {
149   HildonTouchSelector *selector;
150   gchar *date;
151
152   g_return_if_fail (HILDON_IS_DATE_BUTTON (button));
153
154   selector = hildon_picker_button_get_selector (HILDON_PICKER_BUTTON (button));
155
156   hildon_date_selector_select_current_date (HILDON_DATE_SELECTOR (selector),
157                                             year, month, day);
158   date = hildon_touch_selector_get_current_text (HILDON_TOUCH_SELECTOR (selector));
159
160   hildon_button_set_value (HILDON_BUTTON (button), date);
161
162   g_free (date);
163 }