Added virtual method pack_toolbar in hildon2 window
[modest] / src / hildon2 / modest-hildon2-window.h
1 /* Copyright (c) 2008 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 #ifndef __MODEST_HILDON2_WINDOW_H__
31 #define __MODEST_HILDON2_WINDOW_H__
32
33 #include <widgets/modest-window.h>
34 #include <widgets/modest-account-view.h>
35 #include <modest-dimming-rule.h>
36
37 G_BEGIN_DECLS
38
39 /* convenience macros */
40 #define MODEST_TYPE_HILDON2_WINDOW             (modest_hildon2_window_get_type())
41 #define MODEST_HILDON2_WINDOW(obj)             (G_TYPE_CHECK_INSTANCE_CAST((obj),MODEST_TYPE_HILDON2_WINDOW,ModestHildon2Window))
42 #define MODEST_HILDON2_WINDOW_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST((klass),MODEST_TYPE_HILDON2_WINDOW,ModestWindow))
43
44 #define MODEST_IS_HILDON2_WINDOW(obj)          (G_TYPE_CHECK_INSTANCE_TYPE((obj),MODEST_TYPE_HILDON2_WINDOW))
45 #define MODEST_IS_HILDON2_WINDOW_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE((klass),MODEST_TYPE_HILDON2_WINDOW))
46 #define MODEST_HILDON2_WINDOW_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS((obj),MODEST_TYPE_HILDON2_WINDOW,ModestHildon2WindowClass))
47
48 typedef struct _ModestHildon2Window      ModestHildon2Window;
49 typedef struct _ModestHildon2WindowClass ModestHildon2WindowClass;
50
51 struct _ModestHildon2Window {
52         ModestWindow parent;
53 };
54
55 struct _ModestHildon2WindowClass {
56         ModestWindowClass parent_class;
57
58         void (*pack_toolbar_func) (ModestHildon2Window *self, GtkPackType pack_type, GtkWidget *toolbar);
59 };
60
61 typedef void (*ModestHildon2AppMenuCallback) (GObject *control, gpointer userdata);
62
63 #define APP_MENU_CALLBACK(x) ((ModestHildon2AppMenuCallback) (x))
64
65 /**
66  * modest_hildon2_window_get_type:
67  * 
68  * get the GType for the ModestHildon2Window class
69  *
70  * Returns: a GType for ModestHildon2Window
71  */
72 GType modest_hildon2_window_get_type (void) G_GNUC_CONST;
73
74 /**
75  * modest_hildon2_window_add_to_menu:
76  * @self: a #ModestHildon2Window
77  * @label: the label of the button added to menu
78  * @callback: a #ModestHildon2AppMenuCallback
79  * @dimming_callback: a #ModestDimmingCallback or %NULL for no dimming rule
80  *
81  * creates a button in the window #HildonAppMenu, with label @label.
82  * It will call @callback, and will configure @dimming_callback for
83  * dimming.
84  */
85 void 
86 modest_hildon2_window_add_to_menu (ModestHildon2Window *self,
87                                    gchar *label,
88                                    ModestHildon2AppMenuCallback callback,
89                                    ModestDimmingCallback dimming_callback);
90
91 /**
92  * modest_hildon2_window_add_button_to_menu:
93  * @self: a #ModestHildon2Window
94  * @button: a #GtkButton
95  * @dimming_callback: a #ModestDimmingCallback or %NULL for no dimming rule
96  *
97  * adds a previously configured button @button to the window #HildonAppMenu.
98  * It will configure @dimming_callback for dimming. User should previously
99  * attach the proper signal handler for @button.
100  */
101 void 
102 modest_hildon2_window_add_button_to_menu (ModestHildon2Window *self,
103                                           GtkButton *button,
104                                           ModestDimmingCallback dimming_callback);
105
106
107
108 G_END_DECLS
109
110 #endif