2 * This file is part of hildon-libs
4 * Copyright (C) 2005, 2006 Nokia Corporation, all rights reserved.
6 * Contact: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
7 * Fixes: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public License
11 * as published by the Free Software Foundation; version 2.1 of
12 * the License or any later version.
14 * This library is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
27 * SECTION:hildon-wizard-dialog
28 * @short_description: A widget to create a guided installation
31 * #HildonWizardDialog is a widget to create a guided installation
32 * process. The dialog has four standard buttons, previous, next,
33 * finish, cancel, and contains several pages with optional icons.
34 * Response buttons are dimmed/undimmed automatically and the standard
35 * icon is shown/hidden in response to page navigation. The notebook
36 * widget provided by users contains the actual wizard pages.
39 #include <gtk/gtkdialog.h>
40 #include <gtk/gtknotebook.h>
41 #include <gtk/gtkimage.h>
42 #include <gtk/gtkbox.h>
43 #include <gtk/gtkhbox.h>
44 #include <gtk/gtkvbox.h>
45 #include <gtk/gtkbutton.h>
46 #include <hildon-widgets/hildon-defines.h>
48 #include "hildon-wizard-dialog.h"
56 #define _(String) dgettext(PACKAGE, String)
58 static GtkDialogClass *parent_class;
60 static void class_init (HildonWizardDialogClass *wizard_dialog_class);
62 static void init (HildonWizardDialog *wizard_dialog);
64 static void create_title (HildonWizardDialog *wizard_dialog);
66 static void set_property (GObject *object,
71 static void get_property (GObject *object,
76 static void finalize (GObject *object);
78 static void response (HildonWizardDialog *wizard,
82 static void make_buttons_sensitive (HildonWizardDialog *wizard_dialog,
93 struct _HildonWizardDialogPrivate {
95 GtkNotebook *notebook;
102 hildon_wizard_dialog_get_type (void)
104 static GType wizard_dialog_type = 0;
106 if (!wizard_dialog_type) {
108 static const GTypeInfo wizard_dialog_info = {
109 sizeof (HildonWizardDialogClass),
110 NULL, /* base_init */
111 NULL, /* base_finalize */
112 (GClassInitFunc) class_init,
113 NULL, /* class_finalize */
114 NULL, /* class_data */
115 sizeof (HildonWizardDialog),
117 (GInstanceInitFunc) init,
120 wizard_dialog_type = g_type_register_static (GTK_TYPE_DIALOG,
121 "HildonWizardDialog",
126 return wizard_dialog_type;
130 class_init (HildonWizardDialogClass *wizard_dialog_class)
132 GObjectClass *object_class = G_OBJECT_CLASS (wizard_dialog_class);
134 parent_class = g_type_class_peek_parent (wizard_dialog_class);
136 g_type_class_add_private (wizard_dialog_class,
137 sizeof(HildonWizardDialogPrivate));
139 /* Override virtual methods */
140 object_class->set_property = set_property;
141 object_class->get_property = get_property;
142 object_class->finalize = finalize;
145 * HildonWizardDialog:wizard-name:
147 * The name of the wizard.
149 g_object_class_install_property (object_class, PROP_WIZARD_NAME,
153 "The name of the HildonWizardDialog",
158 * HildonWizardDialog:wizard-notebook:
160 * The notebook object, which is used by the HildonWizardDialog.
162 g_object_class_install_property(object_class, PROP_WIZARD_NOTEBOOK,
166 "GtkNotebook object to be used in the "
167 "HildonWizardDialog",
168 GTK_TYPE_NOTEBOOK, G_PARAM_READWRITE));
172 finalize (GObject *object)
174 HildonWizardDialog *dialog = HILDON_WIZARD_DIALOG (object);
175 g_return_if_fail (dialog != NULL);
177 if (dialog->priv->wizard_name != NULL)
178 g_free (HILDON_WIZARD_DIALOG (object)->priv->wizard_name);
180 if (G_OBJECT_CLASS (parent_class)->finalize)
181 G_OBJECT_CLASS (parent_class)->finalize(object);
184 /* Disable or enable the Previous, Next and Finish buttons */
186 make_buttons_sensitive (HildonWizardDialog *wizard_dialog,
191 gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
192 HILDON_WIZARD_DIALOG_PREVIOUS,
195 gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
196 HILDON_WIZARD_DIALOG_FINISH,
199 gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
200 HILDON_WIZARD_DIALOG_NEXT,
205 init (HildonWizardDialog *wizard_dialog)
207 /* Initialize private structure for faster member access */
208 HildonWizardDialogPrivate *priv =
209 G_TYPE_INSTANCE_GET_PRIVATE (wizard_dialog,
210 HILDON_TYPE_WIZARD_DIALOG,
211 HildonWizardDialogPrivate);
213 GtkDialog *dialog = GTK_DIALOG (wizard_dialog);
215 /* Init internal widgets */
216 GtkWidget *vbox = gtk_vbox_new (FALSE, 0);
217 gtk_dialog_set_has_separator (dialog, FALSE);
218 wizard_dialog->priv = priv;
219 priv->box = GTK_BOX (gtk_hbox_new (FALSE, 0));
220 priv->image = gtk_image_new_from_icon_name ("qgn_widg_wizard",
221 HILDON_ICON_SIZE_WIDG_WIZARD);
223 /* Default values for user provided properties */
224 priv->notebook = NULL;
225 priv->wizard_name = NULL;
227 /* Build wizard layout */
228 gtk_box_pack_start_defaults (GTK_BOX (dialog->vbox), GTK_WIDGET (priv->box));
229 gtk_box_pack_start_defaults (GTK_BOX (priv->box), GTK_WIDGET (vbox));
230 gtk_box_pack_start (GTK_BOX (vbox), GTK_WIDGET (priv->image), FALSE, FALSE, 0);
232 /* Add response buttons: finish, previous, next, cancel */
233 gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_finish"), HILDON_WIZARD_DIALOG_FINISH);
234 gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_previous"), HILDON_WIZARD_DIALOG_PREVIOUS);
235 gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_next"), HILDON_WIZARD_DIALOG_NEXT);
236 gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_cancel"), HILDON_WIZARD_DIALOG_CANCEL);
238 /* Set initial button states: previous and finish buttons are disabled */
239 make_buttons_sensitive (wizard_dialog, FALSE, FALSE, TRUE);
241 /* Show all the internal widgets */
242 gtk_widget_show_all (GTK_WIDGET (dialog->vbox));
244 /* connect to dialog's response signal */
245 g_signal_connect (G_OBJECT (dialog), "response",
246 G_CALLBACK (response), NULL);
250 set_property (GObject *object,
255 HildonWizardDialogPrivate *priv = HILDON_WIZARD_DIALOG(object)->priv;
257 switch (property_id) {
259 case PROP_WIZARD_NAME:
261 /* Set new wizard name. This name will appear in titlebar */
262 if (priv->wizard_name)
263 g_free (priv->wizard_name);
265 gchar *str = (gchar *) g_value_get_string (value);
266 g_return_if_fail (str != NULL);
268 priv->wizard_name = g_strdup (str);
270 /* We need notebook in order to create title, since page information
271 is used in title generation */
274 create_title (HILDON_WIZARD_DIALOG (object));
278 case PROP_WIZARD_NOTEBOOK: {
280 GtkNotebook *book = GTK_NOTEBOOK (g_value_get_object (value));
281 g_return_if_fail (book != NULL);
283 priv->notebook = book;
285 /* Set the default properties for the notebook (disable tabs,
286 * and remove borders) to make it look like a nice wizard widget */
287 gtk_notebook_set_show_tabs (priv->notebook, FALSE);
288 gtk_notebook_set_show_border (priv->notebook, FALSE);
289 gtk_box_pack_start_defaults (GTK_BOX( priv->box), GTK_WIDGET (priv->notebook));
291 /* Show the notebook so that a gtk_widget_show on the dialog is
292 * all that is required to display the dialog correctly */
293 gtk_widget_show (priv->notebook);
295 /* Update dialog title to reflect current page stats etc */
296 if (priv->wizard_name)
297 create_title (HILDON_WIZARD_DIALOG (object));
302 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
308 get_property (GObject *object,
313 HildonWizardDialogPrivate *priv = HILDON_WIZARD_DIALOG (object)->priv;
315 switch (property_id) {
317 case PROP_WIZARD_NAME:
318 g_value_set_string (value, priv->wizard_name);
321 case PROP_WIZARD_NOTEBOOK:
322 g_value_set_object (value, priv->notebook);
326 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
332 * Creates the title of the dialog taking into account the current
333 * page of the notebook.
336 create_title (HildonWizardDialog *wizard_dialog)
340 HildonWizardDialogPrivate *priv = wizard_dialog->priv;
341 GtkNotebook *notebook = priv->notebook;
346 /* Get page information, we'll need that when creating title */
347 pages = gtk_notebook_get_n_pages (notebook);
348 current = gtk_notebook_get_current_page (priv->notebook);
352 /* the welcome title on the initial page */
354 str = g_strdup_printf (_("ecdg_ti_wizard_welcome"),
355 priv->wizard_name, pages);
357 const gchar *steps = gtk_notebook_get_tab_label_text (notebook,
358 gtk_notebook_get_nth_page (notebook, current));
360 str = g_strdup_printf (_("ecdg_ti_wizard_step"),
361 priv->wizard_name, current + 1, pages, steps);
364 /* Update the dialog to display the generated title */
365 gtk_window_set_title (GTK_WINDOW (wizard_dialog), str);
370 * Response signal handler. This function is needed because GtkDialog's
371 * handler for this signal closes the dialog and we don't want that, we
372 * want to change pages and, dimm certain response buttons. Overriding the
373 * virtual function would not work because that would be called after the
374 * signal handler implemented by GtkDialog.
375 * FIXME: There is a much saner way to do that [MDK]
378 response (HildonWizardDialog *wizard_dialog,
382 HildonWizardDialogPrivate *priv = wizard_dialog->priv;
383 GtkNotebook *notebook = priv->notebook;
385 gint last = gtk_notebook_get_n_pages (notebook) - 1;
386 gboolean is_first, is_last;
388 switch (response_id) {
390 case HILDON_WIZARD_DIALOG_PREVIOUS:
391 gtk_notebook_prev_page (notebook); /* go to previous page */
394 case HILDON_WIZARD_DIALOG_NEXT:
395 gtk_notebook_next_page (notebook); /* go to next page */
398 case HILDON_WIZARD_DIALOG_CANCEL:
399 case HILDON_WIZARD_DIALOG_FINISH:
404 current = gtk_notebook_get_current_page (notebook);
405 is_last = current == last;
406 is_first = current == 0;
408 /* If first page, previous and finish are disabled,
409 if last page, next is disabled */
410 make_buttons_sensitive (wizard_dialog,
411 !is_first, !is_first, !is_last);
413 /* Don't let the dialog close */
414 g_signal_stop_emission_by_name (wizard_dialog, "response");
416 /* We show the default image on first and last pages */
417 if (current == last || current == 0)
418 gtk_widget_show (GTK_WIDGET(priv->image));
420 gtk_widget_hide (GTK_WIDGET(priv->image));
422 /* New page number may appear in the title, update it */
423 create_title (wizard_dialog);
427 * hildon_wizard_dialog_new:
428 * @parent: a #GtkWindow
429 * @wizard_name: the name of dialog
430 * @notebook: the notebook to be shown on the dialog
432 * Creates a new #HildonWizardDialog.
434 * Returns: a new #HildonWizardDialog
437 hildon_wizard_dialog_new (GtkWindow *parent,
438 const char *wizard_name,
439 GtkNotebook *notebook)
443 g_return_val_if_fail (GTK_IS_NOTEBOOK (notebook), NULL);
445 widget = GTK_WIDGET (g_object_new
446 (HILDON_TYPE_WIZARD_DIALOG,
447 "wizard-name", wizard_name,
448 "wizard-notebook", notebook, NULL));
451 gtk_window_set_transient_for (GTK_WINDOW (widget), parent);