Added bug 90185 to changelog
[modest] / src / modest-dimming-rules-group.c
1 /* Copyright (c) 2006, Nokia Corporation
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  *   notice, this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright
11  *   notice, this list of conditions and the following disclaimer in the
12  *   documentation and/or other materials provided with the distribution.
13  * * Neither the name of the Nokia Corporation nor the names of its
14  *   contributors may be used to endorse or promote products derived from
15  *   this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30 #include "modest-dimming-rules-group.h"
31 #include "modest-dimming-rules-group-priv.h"
32 #include "modest-dimming-rule.h"
33 #include "modest-platform.h"
34 #include "modest-ui-dimming-rules.h"
35
36 static void modest_dimming_rules_group_class_init (ModestDimmingRulesGroupClass *klass);
37 static void modest_dimming_rules_group_init       (ModestDimmingRulesGroup *obj);
38 static void modest_dimming_rules_group_finalize   (GObject *obj);
39
40 static void _insensitive_press_callback (GtkWidget *widget, gpointer user_data);
41
42 static void on_window_destroy (gpointer data,
43                                GObject *object);
44
45 static void _add_rule (ModestDimmingRulesGroup *self,
46                        ModestDimmingRule *rule,
47                        ModestWindow *window);
48
49 typedef struct _ModestDimmingRulesGroupPrivate ModestDimmingRulesGroupPrivate;
50 struct _ModestDimmingRulesGroupPrivate {        
51         ModestWindow *window;
52         gchar *name;
53         gboolean notifications_enabled;
54         GHashTable *rules_map;
55         GSList *widget_rules;
56 };
57
58
59 #define MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(o)      (G_TYPE_INSTANCE_GET_PRIVATE((o), \
60                                                    MODEST_TYPE_DIMMING_RULES_GROUP, \
61                                                    ModestDimmingRulesGroupPrivate))
62
63 /* globals */
64 static GObjectClass *parent_class = NULL;
65
66 static void _execute_dimming_rule (gpointer key, gpointer value, gpointer user_data);
67 static void _execute_widget_dimming_rule (gpointer data, gpointer user_data);
68 static void _insensitive_press_callback (GtkWidget *widget, gpointer user_data);
69
70
71
72 GType
73 modest_dimming_rules_group_get_type (void)
74 {
75         static GType my_type = 0;
76         if (!my_type) {
77                 static const GTypeInfo my_info = {
78                         sizeof(ModestDimmingRulesGroupClass),
79                         NULL,           /* base init */
80                         NULL,           /* base finalize */
81                         (GClassInitFunc) modest_dimming_rules_group_class_init,
82                         NULL,           /* class finalize */
83                         NULL,           /* class data */
84                         sizeof(ModestDimmingRulesGroup),
85                         1,              /* n_preallocs */
86                         (GInstanceInitFunc) modest_dimming_rules_group_init,
87                         NULL
88                 };
89                 my_type = g_type_register_static (G_TYPE_OBJECT,
90                                                   "ModestDimmingRulesGroup",
91                                                   &my_info, 0);
92         }
93         return my_type;
94 }
95
96 static void
97 modest_dimming_rules_group_class_init (ModestDimmingRulesGroupClass *klass)
98 {
99         GObjectClass *gobject_class;
100         gobject_class = (GObjectClass*) klass;
101
102         parent_class            = g_type_class_peek_parent (klass);
103         gobject_class->finalize = modest_dimming_rules_group_finalize;
104
105         g_type_class_add_private (gobject_class, sizeof(ModestDimmingRulesGroupPrivate));
106 }
107
108 static void
109 modest_dimming_rules_group_init (ModestDimmingRulesGroup *obj)
110 {
111         ModestDimmingRulesGroupPrivate *priv;
112
113         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(obj);
114
115         priv->name = NULL;
116         priv->window = NULL;
117         priv->notifications_enabled = FALSE;
118         priv->rules_map = g_hash_table_new_full ((GHashFunc) g_str_hash,
119                                                  (GEqualFunc) g_str_equal,
120                                                  (GDestroyNotify) g_free,
121                                                  (GDestroyNotify) g_object_unref);
122         priv->widget_rules = NULL;
123 }
124
125 static void
126 modest_dimming_rules_group_finalize (GObject *obj)
127 {
128         ModestDimmingRulesGroupPrivate *priv;
129
130         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(obj);
131
132         if (priv->name != NULL)
133                 g_free(priv->name);
134
135         if (priv->rules_map != NULL)
136                 g_hash_table_destroy (priv->rules_map);
137
138         if (priv->widget_rules != NULL)
139                 g_slist_foreach (priv->widget_rules, (GFunc) g_object_unref, NULL);
140
141         G_OBJECT_CLASS(parent_class)->finalize (obj);
142 }
143
144
145 ModestDimmingRulesGroup*
146 modest_dimming_rules_group_new(const gchar *group_name,
147                                gboolean notifications_enabled)
148 {
149         ModestDimmingRulesGroup *obj;
150         ModestDimmingRulesGroupPrivate *priv;
151                 
152         g_return_val_if_fail (group_name != NULL, NULL);
153
154         obj = MODEST_DIMMING_RULES_GROUP(g_object_new(MODEST_TYPE_DIMMING_RULES_GROUP, NULL));
155
156         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(obj);
157         priv->name = g_strdup(group_name);
158         priv->notifications_enabled = notifications_enabled;
159
160         return obj;
161 }
162
163
164 gchar *
165 modest_dimming_rules_group_get_name (ModestDimmingRulesGroup *self) 
166 {
167         ModestDimmingRulesGroupPrivate *priv;
168         
169         g_return_val_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self), NULL);
170
171         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
172         
173         return g_strdup (priv->name);
174 }
175
176 static void
177 _add_rule (ModestDimmingRulesGroup *self,
178            ModestDimmingRule *rule,
179            ModestWindow *window)
180 {
181         ModestDimmingRulesGroupPrivate *priv;
182         GtkWidget *widget = NULL;
183         const gchar *action_path = NULL;
184
185         g_return_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self));
186         g_return_if_fail (MODEST_IS_WINDOW(window));
187         g_return_if_fail (MODEST_IS_DIMMING_RULE (rule));
188         
189         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
190
191         /* Set window to process dimming rules */
192         priv->window = MODEST_WINDOW (window);
193
194         widget = modest_dimming_rule_get_widget (rule);
195         /* Connect insensitive-presss handler to show notifications */
196         g_signal_connect (G_OBJECT (widget), "insensitive-press", 
197                           G_CALLBACK (_insensitive_press_callback), 
198                           rule);
199
200         /* Register new dimming rule */         
201         modest_dimming_rule_set_group (rule, self);
202         action_path = modest_dimming_rule_get_action_path (rule);
203         if (action_path)
204                 g_hash_table_insert (priv->rules_map, g_strdup(action_path), rule);
205         else
206                 priv->widget_rules = g_slist_prepend (priv->widget_rules, rule);
207 }
208
209 void
210 modest_dimming_rules_group_add_widget_rule (ModestDimmingRulesGroup *self,
211                                             GtkWidget *widget,
212                                             GCallback callback,
213                                             ModestWindow *window)
214 {
215         ModestDimmingRulesGroupPrivate *priv;
216         ModestDimmingRule *dim_rule = NULL;
217
218         g_return_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self));
219         g_return_if_fail (GTK_IS_WIDGET (widget));
220         g_return_if_fail (MODEST_IS_WINDOW(window));
221         
222         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
223
224         /* Set window to process dimming rules */
225         priv->window = MODEST_WINDOW (window);
226
227         dim_rule = modest_dimming_rule_new_from_widget (priv->window,
228                                                         (ModestDimmingCallback) callback,
229                                                         widget);
230
231         _add_rule (self, dim_rule, window);
232 }
233
234 void
235 modest_dimming_rules_group_add_rules (ModestDimmingRulesGroup *self,
236                                       const ModestDimmingEntry modest_dimming_entries[],
237                                       guint n_elements,
238                                       ModestWindow *window)
239 {
240         ModestDimmingRulesGroupPrivate *priv;
241         ModestDimmingRule *dim_rule = NULL;
242         ModestDimmingEntry entry;
243         GtkWidget *widget = NULL;
244         gboolean unique = FALSE;
245         guint i;
246
247         g_return_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self));
248         g_return_if_fail (modest_dimming_entries != NULL);
249         g_return_if_fail (n_elements > 0);
250         g_return_if_fail (MODEST_IS_WINDOW(window));
251         
252         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
253
254         /* Set window to process dimming rules */
255         priv->window = MODEST_WINDOW (window);
256         g_object_weak_ref (G_OBJECT (window), on_window_destroy, self);
257
258         /* Add dimming rules */
259         for (i=0; i < n_elements; i++) {
260                 entry = modest_dimming_entries[i]; 
261                 
262                 /* Check dimming_rule and action path are NOT NULL */
263                 if (entry.action_path == NULL) continue;
264                 if (entry.callback == NULL) continue;
265                 
266                 /* Check action path is unique */
267                 unique = g_hash_table_lookup (priv->rules_map, entry.action_path) == NULL;
268                 if (!unique) continue;
269
270                 /* Check action path is valid */
271                 widget = modest_window_get_action_widget (MODEST_WINDOW (window), entry.action_path);
272                 if (widget == NULL) continue;
273
274                 /* Create a new dimming rule */
275                 dim_rule = modest_dimming_rule_new (priv->window,
276                                                     (ModestDimmingCallback) entry.callback,
277                                                     entry.action_path);
278
279                 _add_rule (self, dim_rule, window);
280         }
281 }
282
283 gboolean 
284 modest_dimming_rules_group_notifications_enabled (ModestDimmingRulesGroup *self)
285 {
286         ModestDimmingRulesGroupPrivate *priv;
287
288         g_return_val_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self), FALSE);
289         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
290         
291         return priv->notifications_enabled;
292
293
294 void 
295 modest_dimming_rules_group_execute (ModestDimmingRulesGroup *self) 
296 {
297         ModestDimmingRulesGroupPrivate *priv;
298         DimmedState *state = NULL;
299
300         g_return_if_fail (MODEST_IS_DIMMING_RULES_GROUP(self));
301         priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE(self);
302
303         if (!priv->window)
304                 return;
305
306         /* Init dimming rules init data */
307         state = modest_ui_dimming_rules_define_dimming_state (priv->window);    
308         modest_window_set_dimming_state (priv->window, state);
309
310         /* execute group dimming rules */
311         g_hash_table_foreach (priv->rules_map, _execute_dimming_rule, NULL);
312         g_slist_foreach (priv->widget_rules, (GFunc) _execute_widget_dimming_rule, NULL);
313
314         /* Free dimming ruls init data */
315         modest_window_set_dimming_state (priv->window, NULL);
316 }
317
318
319 static void
320 _execute_dimming_rule (gpointer key, gpointer value, gpointer user_data)
321 {
322         g_return_if_fail (MODEST_IS_DIMMING_RULE (value));
323
324         /* Process dimming rule */
325         modest_dimming_rule_process (MODEST_DIMMING_RULE(value));
326 }
327
328 static void
329 _execute_widget_dimming_rule (gpointer data, gpointer user_data)
330 {
331         g_return_if_fail (MODEST_IS_DIMMING_RULE (data));
332
333         /* Process dimming rule */
334         modest_dimming_rule_process (MODEST_DIMMING_RULE(data));
335 }
336
337 static void
338 _insensitive_press_callback (GtkWidget *widget, gpointer user_data)
339 {
340         ModestDimmingRulesGroup *group = NULL;
341         ModestDimmingRule *rule = NULL;
342         gchar *notification = NULL;
343
344         g_return_if_fail (MODEST_IS_DIMMING_RULE (user_data));
345         rule = MODEST_DIMMING_RULE (user_data);
346
347         /* Check if this group has notification system enabled */
348         group = modest_dimming_rule_get_group (rule);
349         if (!modest_dimming_rules_group_notifications_enabled (group))
350                 goto frees;
351
352         /* Get specific notification */
353         notification = modest_dimming_rule_get_notification (rule);
354         if (notification == NULL)
355                 goto frees;
356         
357         /* Show notification banner */
358         modest_platform_information_banner (NULL, NULL, notification);  
359         
360         /* Free */
361  frees:
362         if (group != NULL)
363                 g_object_unref(group);
364         if (notification != NULL)
365                 g_free(notification);
366 }
367
368 static void
369 on_window_destroy (gpointer data,
370                    GObject *object)
371 {
372         ModestDimmingRulesGroup *self = MODEST_DIMMING_RULES_GROUP (data);
373         ModestDimmingRulesGroupPrivate *priv = MODEST_DIMMING_RULES_GROUP_GET_PRIVATE (self);
374
375         priv->window = NULL;
376 }