HildonTouchSelector documentation updates
[hildon] / hildon / hildon-dialog.h
1 /*
2  * This file is a part of hildon
3  *
4  * Copyright (C) 2008 Nokia Corporation, all rights reserved.
5  *
6  * Contact: Rodrigo Novo <rodrigo.novo@nokia.com>
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public License
10  * as published by the Free Software Foundation; version 2.1 of
11  * the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful, but
14  * WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
21  * 02110-1301 USA
22  *
23  */
24
25 #ifndef                                         HILDON_DISABLE_DEPRECATED
26
27 #ifndef                                         __HILDON_DIALOG_H__
28 #define                                         __HILDON_DIALOG_H__
29
30 #include                                        <gtk/gtk.h>
31
32 #include                                        "hildon-defines.h"
33
34 G_BEGIN_DECLS
35
36 #define                                         HILDON_TYPE_DIALOG \
37                                                 (hildon_dialog_get_type ())
38
39 #define                                         HILDON_DIALOG(obj) \
40                                                 (G_TYPE_CHECK_INSTANCE_CAST (obj, \
41                                                 HILDON_TYPE_DIALOG, HildonDialog))
42
43 #define                                         HILDON_DIALOG_CLASS(klass) \
44                                                 (G_TYPE_CHECK_CLASS_CAST ((klass),\
45                                                 HILDON_TYPE_DIALOG, HildonDialogClass))
46
47 #define                                         HILDON_IS_DIALOG(obj) \
48                                                 (G_TYPE_CHECK_INSTANCE_TYPE (obj, HILDON_TYPE_DIALOG))
49
50 #define                                         HILDON_IS_DIALOG_CLASS(klass) \
51                                                 (GTK_CHECH_CLASS_TYPE ((klass), HILDON_TYPE_DIALOG))
52
53 #define                                         HILDON_DIALOG_GET_CLASS(obj) \
54                                                 ((HildonDialogClass *) G_OBJECT_GET_CLASS (obj))
55
56 typedef struct                                  _HildonDialog HildonDialog;
57
58 typedef struct                                  _HildonDialogClass HildonDialogClass;
59
60 struct                                          _HildonDialog
61 {
62     GtkDialog parent;
63 };
64
65 struct                                          _HildonDialogClass
66 {
67     GtkDialogClass parent_class;
68
69     /* Padding for future extension */
70     void (*_hildon_reserved1)(void);
71     void (*_hildon_reserved2)(void);
72     void (*_hildon_reserved3)(void);
73 };
74
75 GType G_GNUC_CONST
76 hildon_dialog_get_type                          (void);
77
78 GtkWidget*
79 hildon_dialog_new                               (void);
80
81 GtkWidget*
82 hildon_dialog_new_with_buttons                  (const gchar    *title,
83                                                  GtkWindow      *parent,
84                                                  GtkDialogFlags  flags,
85                                                  const gchar    *first_button_text,
86                                                  ...);
87
88 GtkWidget *
89 hildon_dialog_add_button                        (HildonDialog *dialog,
90                                                  const gchar  *button_text,
91                                                  gint          response_id);
92
93 void
94 hildon_dialog_add_buttons                       (HildonDialog *dialog,
95                                                  const gchar  *first_button_text,
96                                                  ...);
97
98 G_END_DECLS
99
100 #endif                                          /* __HILDON_DIALOG_H__ */
101
102 #endif                                          /* HILDON_DISABLE_DEPRECATED */