git.maemo.org Git - modest/blob - src/maemo/easysetup/modest-wizard-dialog.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 /**
  31  * SECTION:modest-wizard-dialog
  32  * @short_description: A widget to create a guided installation
  33  * process wizard
  34  *
  35  * #ModestWizardDialog is a widget to create a guided installation
  36  * process. The dialog has four standard buttons, previous, next,
  37  * finish, cancel, and contains several pages with optional icons.
  38  * Response buttons are dimmed/undimmed automatically and the standard
  39  * icon is shown/hidden in response to page navigation. The notebook
  40  * widget provided by users contains the actual wizard pages.
  41  */
  42
  43 #include <config.h>
  44 #include <gtk/gtkdialog.h>
  45 #include <gtk/gtknotebook.h>
  46 #include <gtk/gtkimage.h>
  47 #include <gtk/gtkbox.h>
  48 #include <gtk/gtkhbox.h>
  49 #include <gtk/gtkvbox.h>
  50 #include <gtk/gtkbutton.h>
  51 #include <gtk/gtk.h>
  52
  53 #ifdef HAVE_CONFIG_H
  54 #include <config.h>
  55 #endif
  56
  57 #ifdef MODEST_HAVE_HILDON0_WIDGETS
  58 #include <hildon-widgets/hildon-defines.h>
  59 #else
  60 #include <hildon/hildon-defines.h>
  61 #endif /*MODEST_HAVE_HILDON0_WIDGETS*/
  62
  63 #include "modest-wizard-dialog.h"
  64
  65 #include <libintl.h>
  66
  67 /* Specify the hildon-libs translation domain,
  68  * so we can reuse its translations
  69  * instead of repeating them in our own translations.
  70  */
  71 /* #define _(String) dgettext(PACKAGE, String) */
  72
  73 #define _(String) dgettext("hildon-libs", String)
  74
  75 static GtkDialogClass *parent_class;
  76
  77 static void class_init              (ModestWizardDialogClass   *wizard_dialog_class);
  78
  79 static void init                    (ModestWizardDialog        *wizard_dialog);
  80
  81 static void create_title            (ModestWizardDialog        *wizard_dialog);
  82
  83 static void set_property            (GObject                   *object,
  84                                      guint                     property_id,
  85                                      const GValue              *value,
  86                                      GParamSpec                *pspec);
  87
  88 static void get_property            (GObject                   *object,
  89                                      guint                     property_id,
  90                                      GValue                    *value,
  91                                      GParamSpec                *pspec);
  92
  93 static void finalize                (GObject                   *object);
  94
  95 static void response                (ModestWizardDialog        *wizard,
  96                                      gint                      response_id,
  97                                      gpointer                  unused);
  98
  99 static void make_buttons_sensitive  (ModestWizardDialog *wizard_dialog,
 100                                      gboolean           previous,
 101                                      gboolean           finish,
 102                                      gboolean next);
 103
 104 static gboolean invoke_before_next_vfunc (ModestWizardDialog *wizard_dialog);
 105 static void invoke_enable_buttons_vfunc (ModestWizardDialog *wizard_dialog);
 106
 107 enum {
 108     PROP_ZERO,
 109     PROP_WIZARD_NAME,
 110     PROP_WIZARD_NOTEBOOK,
 111     PROP_WIZARD_AUTOTITLE
 112 };
 113
 114 struct _ModestWizardDialogPrivate {
 115     gchar       *wizard_name;
 116     GtkNotebook *notebook;
 117     GtkBox      *box;
 118     GtkWidget   *image;
 119     gboolean    autotitle;
 120 };
 121
 122
 123 GType
 124 modest_wizard_dialog_get_type (void)
 125 {
 126     static GType wizard_dialog_type = 0;
 127
 128     if (!wizard_dialog_type) {
 129
 130         static const GTypeInfo wizard_dialog_info = {
 131             sizeof (ModestWizardDialogClass),
 132             NULL,       /* base_init      */
 133             NULL,       /* base_finalize  */
 134             (GClassInitFunc) class_init,
 135             NULL,       /* class_finalize */
 136             NULL,       /* class_data     */
 137             sizeof (ModestWizardDialog),
 138             0,          /* n_preallocs    */
 139             (GInstanceInitFunc) init,
 140         };
 141
 142         wizard_dialog_type = g_type_register_static (GTK_TYPE_DIALOG,
 143                                                      "ModestWizardDialog",
 144                                                      &wizard_dialog_info,
 145                                                      0);
 146     }
 147
 148     return wizard_dialog_type;
 149 }
 150
 151 static void
 152 class_init (ModestWizardDialogClass *wizard_dialog_class)
 153 {
 154     GObjectClass *object_class = G_OBJECT_CLASS (wizard_dialog_class);
 155
 156     parent_class = g_type_class_peek_parent (wizard_dialog_class);
 157
 158     g_type_class_add_private (wizard_dialog_class,
 159                               sizeof(ModestWizardDialogPrivate));
 160
 161     /* Override virtual methods */
 162     object_class->set_property = set_property;
 163     object_class->get_property = get_property;
 164     object_class->finalize     = finalize;
 165
 166     /**
 167      * ModestWizardDialog:wizard-name:
 168      *
 169      * The name of the wizard.
 170      */
 171     g_object_class_install_property (object_class, PROP_WIZARD_NAME,
 172             g_param_spec_string
 173             ("wizard-name",
 174              "Wizard Name",
 175              "The name of the ModestWizardDialog",
 176              NULL,
 177              G_PARAM_READWRITE));
 178
 179     /**
 180      * ModestWizardDialog:wizard-notebook:
 181      *
 182      * The notebook object, which is used by the ModestWizardDialog.
 183      */
 184     g_object_class_install_property(object_class, PROP_WIZARD_NOTEBOOK,
 185             g_param_spec_object
 186             ("wizard-notebook",
 187              "Wizard Notebook",
 188              "GtkNotebook object to be used in the "
 189              "ModestWizardDialog",
 190              GTK_TYPE_NOTEBOOK, G_PARAM_READWRITE));
 191
 192     /**
 193      * ModestWizardDialog:autotitle
 194      *
 195      * If the wizard should automatically try to change the window title when changing steps.
 196      * Set to FALSE if you'd like to override the default behaviour.
 197      *
 198      * Since: 0.14.5
 199      */
 200     g_object_class_install_property(object_class, PROP_WIZARD_AUTOTITLE,
 201             g_param_spec_boolean
 202             ("autotitle",
 203              "AutoTitle",
 204              "If the wizard should autotitle itself",
 205              TRUE,
 206              G_PARAM_READWRITE));
 207 }
 208
 209 static void
 210 finalize (GObject *object)
 211 {
 212     ModestWizardDialog *dialog = MODEST_WIZARD_DIALOG (object);
 213     g_return_if_fail (dialog != NULL);
 214
 215     if (dialog->priv->wizard_name != NULL)
 216         g_free (MODEST_WIZARD_DIALOG (object)->priv->wizard_name);
 217
 218     if (G_OBJECT_CLASS (parent_class)->finalize)
 219         G_OBJECT_CLASS (parent_class)->finalize(object);
 220 }
 221
 222 /* Disable or enable the Previous, Next and Finish buttons */
 223 static void
 224 make_buttons_sensitive (ModestWizardDialog *wizard_dialog,
 225                         gboolean previous,
 226                         gboolean finish,
 227                         gboolean next)
 228 {
 229     gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
 230                                        MODEST_WIZARD_DIALOG_PREVIOUS,
 231                                        previous);
 232
 233     gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
 234                                        MODEST_WIZARD_DIALOG_FINISH,
 235                                        finish);
 236
 237     gtk_dialog_set_response_sensitive (GTK_DIALOG (wizard_dialog),
 238                                        MODEST_WIZARD_DIALOG_NEXT,
 239                                        next);
 240 }
 241
 242 static void
 243 init (ModestWizardDialog *wizard_dialog)
 244 {
 245     /* Initialize private structure for faster member access */
 246     ModestWizardDialogPrivate *priv =
 247         G_TYPE_INSTANCE_GET_PRIVATE (wizard_dialog,
 248                 MODEST_TYPE_WIZARD_DIALOG,
 249                 ModestWizardDialogPrivate);
 250
 251     GtkDialog *dialog = GTK_DIALOG (wizard_dialog);
 252
 253     /* Init internal widgets */
 254     GtkWidget *vbox = gtk_vbox_new (FALSE, 0);
 255     gtk_dialog_set_has_separator (dialog, FALSE);
 256     wizard_dialog->priv = priv;
 257     priv->box = GTK_BOX (gtk_hbox_new (FALSE, 0));
 258 #ifdef MODEST_HAVE_HILDON0_WIDGETS
 259     priv->image = gtk_image_new_from_icon_name ("qgn_widg_wizard",
 260                                                 HILDON_ICON_SIZE_WIDG_WIZARD);
 261 #else
 262                 int icon_size = gtk_icon_size_register("hildon_wizard", 50, 50);
 263     priv->image = gtk_image_new_from_icon_name ("qgn_widg_wizard",
 264                                                 icon_size);
 265 #endif /*MODEST_HILDON_VERSION_0*/
 266     /* Default values for user provided properties */
 267     priv->notebook = NULL;
 268     priv->wizard_name = NULL;
 269     priv->autotitle = TRUE;
 270
 271     /* Build wizard layout */
 272     gtk_box_pack_start_defaults (GTK_BOX (dialog->vbox), GTK_WIDGET (priv->box));
 273     gtk_box_pack_start_defaults (GTK_BOX (priv->box), GTK_WIDGET (vbox));
 274     gtk_box_pack_start (GTK_BOX (vbox), GTK_WIDGET (priv->image), FALSE, FALSE, 0);
 275
 276     /* Add response buttons: finish, previous, next, cancel */
 277     gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_finish"), MODEST_WIZARD_DIALOG_FINISH);
 278     gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_previous"), MODEST_WIZARD_DIALOG_PREVIOUS);
 279     gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_next"), MODEST_WIZARD_DIALOG_NEXT);
 280     gtk_dialog_add_button (dialog, _("ecdg_bd_wizard_cancel"), MODEST_WIZARD_DIALOG_CANCEL);
 281
 282     /* Set initial button states: previous and finish buttons are disabled */
 283     make_buttons_sensitive (wizard_dialog, FALSE, FALSE, TRUE);
 284
 285     /* Show all the internal widgets */
 286     gtk_widget_show_all (GTK_WIDGET (dialog->vbox));
 287
 288     /* connect to dialog's response signal */
 289     g_signal_connect (G_OBJECT (dialog), "response",
 290             G_CALLBACK (response), NULL);
 291 }
 292
 293 #if GTK_CHECK_VERSION(2, 10, 0) /* These signals were added in GTK+ 2.10: */
 294 static void on_notebook_page_added(GtkNotebook *notebook,
 295                                    GtkWidget   *child,
 296                                    guint        page_num,
 297                                    gpointer     user_data)
 298 {
 299         ModestWizardDialog* dialog = NULL;
 300
 301         g_return_if_fail (MODEST_IS_WIZARD_DIALOG(user_data));
 302         dialog = MODEST_WIZARD_DIALOG(user_data);
 303
 304         /* The title should show the total number of pages: */
 305         create_title (dialog);
 306 }
 307
 308 static void on_notebook_page_removed(GtkNotebook *notebook,
 309                                      GtkWidget   *child,
 310                                      guint        page_num,
 311                                      gpointer     user_data)
 312 {
 313         ModestWizardDialog* dialog = NULL;
 314
 315         g_return_if_fail (MODEST_IS_WIZARD_DIALOG(user_data));
 316         dialog = MODEST_WIZARD_DIALOG(user_data);
 317
 318         /* The title should show the total number of pages: */
 319         create_title (dialog);
 320 }
 321 #endif /* GTK_CHECK_VERSION */
 322
 323 static void
 324 connect_to_notebook_signals(ModestWizardDialog* dialog)
 325 {
 326 #if GTK_CHECK_VERSION(2, 10, 0) /* These signals were added in GTK+ 2.10: */
 327         ModestWizardDialogPrivate *priv = MODEST_WIZARD_DIALOG(dialog)->priv;
 328         g_return_if_fail (priv->notebook);
 329
 330         /* Connect to the notebook signals,
 331          * so we can update the title when necessary: */
 332         g_signal_connect (G_OBJECT (priv->notebook), "page-added",
 333                       G_CALLBACK (on_notebook_page_added), dialog);
 334         g_signal_connect (G_OBJECT (priv->notebook), "page-removed",
 335                       G_CALLBACK (on_notebook_page_removed), dialog);
 336 #endif /* GTK_CHECK_VERSION */
 337 }
 338
 339
 340 static void
 341 set_property (GObject      *object,
 342               guint        property_id,
 343               const GValue *value,
 344               GParamSpec   *pspec)
 345 {
 346     ModestWizardDialogPrivate *priv = MODEST_WIZARD_DIALOG(object)->priv;
 347
 348     switch (property_id) {
 349
 350         case PROP_WIZARD_AUTOTITLE:
 351
 352             priv->autotitle = g_value_get_boolean (value);
 353
 354             if (priv->autotitle &&
 355                 priv->wizard_name &&
 356                 priv->notebook)
 357                 create_title (MODEST_WIZARD_DIALOG (object));
 358             else if (priv->wizard_name)
 359                 gtk_window_set_title (GTK_WINDOW (object), priv->wizard_name);
 360
 361             break;
 362
 363         case PROP_WIZARD_NAME:
 364
 365             /* Set new wizard name. This name will appear in titlebar */
 366             if (priv->wizard_name)
 367                 g_free (priv->wizard_name);
 368
 369             gchar *str = (gchar *) g_value_get_string (value);
 370             g_return_if_fail (str != NULL);
 371
 372             priv->wizard_name = g_strdup (str);
 373
 374             /* We need notebook in order to create title, since page information
 375                is used in title generation */
 376
 377             if (priv->notebook && priv->autotitle)
 378                 create_title (MODEST_WIZARD_DIALOG (object));
 379
 380             break;
 381
 382         case PROP_WIZARD_NOTEBOOK: {
 383
 384             GtkNotebook *book = GTK_NOTEBOOK (g_value_get_object (value));
 385             g_return_if_fail (book != NULL);
 386
 387             priv->notebook = book;
 388
 389             /* Set the default properties for the notebook (disable tabs,
 390              * and remove borders) to make it look like a nice wizard widget */
 391             gtk_notebook_set_show_tabs (priv->notebook, FALSE);
 392             gtk_notebook_set_show_border (priv->notebook, FALSE);
 393             gtk_box_pack_start_defaults (GTK_BOX( priv->box), GTK_WIDGET (priv->notebook));
 394
 395             /* Show the notebook so that a gtk_widget_show on the dialog is
 396              * all that is required to display the dialog correctly */
 397             gtk_widget_show ( GTK_WIDGET (priv->notebook));
 398
 399             /* Update dialog title to reflect current page stats etc */
 400             ModestWizardDialog *wizard_dialog = MODEST_WIZARD_DIALOG (object);
 401             if (priv->wizard_name && priv->autotitle)
 402                 create_title (wizard_dialog);
 403
 404             connect_to_notebook_signals (wizard_dialog);
 405
 406             }break;
 407
 408         default:
 409             G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
 410             break;
 411     }
 412 }
 413
 414 static void
 415 get_property (GObject      *object,
 416               guint        property_id,
 417               GValue       *value,
 418               GParamSpec   *pspec)
 419 {
 420     ModestWizardDialogPrivate *priv = MODEST_WIZARD_DIALOG (object)->priv;
 421
 422     switch (property_id) {
 423
 424         case PROP_WIZARD_NAME:
 425             g_value_set_string (value, priv->wizard_name);
 426             break;
 427
 428         case PROP_WIZARD_NOTEBOOK:
 429             g_value_set_object (value, priv->notebook);
 430             break;
 431
 432         default:
 433             G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
 434             break;
 435     }
 436 }
 437
 438 /*
 439  * Creates the title of the dialog taking into account the current
 440  * page of the notebook.
 441  */
 442 static void
 443 create_title (ModestWizardDialog *wizard_dialog)
 444 {
 445     gchar *str = NULL;
 446     ModestWizardDialogPrivate *priv = NULL;
 447     GtkNotebook *notebook = NULL;
 448
 449     g_return_if_fail (MODEST_IS_WIZARD_DIALOG(wizard_dialog));
 450     g_return_if_fail (wizard_dialog->priv != NULL);
 451
 452     priv = wizard_dialog->priv;
 453     notebook = priv->notebook;
 454
 455     if (!notebook)
 456         return;
 457
 458     /* Get page information, we'll need that when creating title */
 459     gint pages = gtk_notebook_get_n_pages (notebook);
 460     if (pages == 0)
 461       return;
 462
 463     gint current = gtk_notebook_get_current_page (priv->notebook);
 464     if (current < 0)
 465         current = 0;
 466
 467     /* the welcome title on the initial page */
 468     /* This is the standard wizard title, with, e.g., 1/4 at the end,
 469          * but the Modest UI spec does not want this. */
 470         /*
 471     if (current == 0) {
 472         str = g_strdup_printf (_("ecdg_ti_wizard_welcome"),
 473                 priv->wizard_name, pages);
 474     } else {
 475     */
 476         const gchar *steps = gtk_notebook_get_tab_label_text (notebook,
 477                 gtk_notebook_get_nth_page (notebook, current));
 478
 479                 /* This is the standard wizard title, with, e.g., 1/4 at the end,
 480                  * but the Modest UI spec does not want this.
 481                  */
 482                 /*
 483         str = g_strdup_printf (_("ecdg_ti_wizard_step"),
 484                 priv->wizard_name, current + 1, pages, steps);
 485         */
 486
 487         str = g_strdup_printf (_("%s: %s"),
 488                 priv->wizard_name, steps);
 489     /* } */
 490
 491     /* Update the dialog to display the generated title */
 492     gtk_window_set_title (GTK_WINDOW (wizard_dialog), str);
 493     g_free (str);
 494 }
 495
 496 /*
 497  * Response signal handler. This function is needed because GtkDialog's
 498  * handler for this signal closes the dialog and we don't want that, we
 499  * want to change pages and, dim certain response buttons. Overriding the
 500  * virtual function would not work because that would be called after the
 501  * signal handler implemented by GtkDialog.
 502  * FIXME: There is a much saner way to do that [MDK]
 503  */
 504 static void
 505 response (ModestWizardDialog   *wizard_dialog,
 506           gint                 response_id,
 507           gpointer             unused)
 508 {
 509     ModestWizardDialogPrivate *priv = wizard_dialog->priv;
 510     GtkNotebook *notebook = priv->notebook;
 511     gint current = 0;
 512     gboolean is_first, is_last;
 513
 514     switch (response_id) {
 515
 516         case MODEST_WIZARD_DIALOG_PREVIOUS:
 517             gtk_notebook_prev_page (notebook); /* go to previous page */
 518             break;
 519
 520         case MODEST_WIZARD_DIALOG_NEXT:
 521                 if (invoke_before_next_vfunc (wizard_dialog))
 522                 gtk_notebook_next_page (notebook); /* go to next page */
 523
 524             break;
 525
 526         case MODEST_WIZARD_DIALOG_CANCEL:
 527                 return;
 528                 break;
 529         case MODEST_WIZARD_DIALOG_FINISH:
 530                 if (invoke_before_next_vfunc (wizard_dialog))
 531                 return;
 532
 533             break;
 534
 535     }
 536
 537     current = gtk_notebook_get_current_page (notebook);
 538     gint last = gtk_notebook_get_n_pages (notebook) - 1;
 539     is_last = current == last;
 540     is_first = current == 0;
 541
 542     /* If first page, previous and finish are disabled,
 543        if last page, next is disabled */
 544     make_buttons_sensitive (wizard_dialog,
 545             !is_first /* previous */, !is_first /* finish */, !is_last /* next*/);
 546
 547     /* Allow derived classes to disable buttons to prevent navigation,
 548      * according to their own validation logic: */
 549     invoke_enable_buttons_vfunc (wizard_dialog);
 550
 551     /* Don't let the dialog close */
 552     g_signal_stop_emission_by_name (wizard_dialog, "response");
 553
 554     /* We show the default image on first and last pages */
 555     last = gtk_notebook_get_n_pages (notebook) - 1;
 556     if (current == last || current == 0)
 557         gtk_widget_show (GTK_WIDGET(priv->image));
 558     else
 559         gtk_widget_hide (GTK_WIDGET(priv->image));
 560
 561     /* New page number may appear in the title, update it */
 562     if (priv->autotitle)
 563         create_title (wizard_dialog);
 564 }
 565
 566 /**
 567  * modest_wizard_dialog_new:
 568  * @parent: a #GtkWindow
 569  * @wizard_name: the name of dialog
 570  * @notebook: the notebook to be shown on the dialog
 571  *
 572  * Creates a new #ModestWizardDialog.
 573  *
 574  * Returns: a new #ModestWizardDialog
 575  */
 576 GtkWidget*
 577 modest_wizard_dialog_new (GtkWindow   *parent,
 578                           const char  *wizard_name,
 579                           GtkNotebook *notebook)
 580 {
 581     GtkWidget *widget;
 582
 583     g_return_val_if_fail (GTK_IS_NOTEBOOK (notebook), NULL);
 584
 585     widget = GTK_WIDGET (g_object_new
 586             (MODEST_TYPE_WIZARD_DIALOG,
 587              "wizard-name", wizard_name,
 588              "wizard-notebook", notebook, NULL));
 589
 590     if (parent)
 591         gtk_window_set_transient_for (GTK_WINDOW (widget), parent);
 592
 593     return widget;
 594 }
 595
 596 /**
 597  * modest_wizard_dialog_force_title_update:
 598  * @wizard_dialog: The wizard dialog
 599  *
 600  * Force the title to be rebuilt, for instance when you have added or
 601  * removed notebook pages. This function is not necessary when using GTK+ 2.10,
 602  * because that has GtkNotebook signals that will be used to update the title
 603  * automatically.
 604  */
 605 void
 606 modest_wizard_dialog_force_title_update (ModestWizardDialog   *wizard_dialog)
 607 {
 608         create_title (wizard_dialog);
 609 }
 610
 611 static gboolean
 612 invoke_before_next_vfunc (ModestWizardDialog *wizard_dialog)
 613 {
 614         ModestWizardDialogClass *klass = MODEST_WIZARD_DIALOG_GET_CLASS (wizard_dialog);
 615
 616         /* Call the vfunc, which may be overridden by derived classes: */
 617         if (klass->before_next) {
 618                 ModestWizardDialogPrivate *priv = MODEST_WIZARD_DIALOG(wizard_dialog)->priv;
 619
 620                 gint current_page_num = gtk_notebook_get_current_page (priv->notebook);
 621
 622                 /* Get widgets for the two pages: */
 623                 GtkWidget* current_page_widget = gtk_notebook_get_nth_page (priv->notebook, current_page_num);
 624
 625                 GtkWidget* next_page_widget = NULL;
 626                 if ((current_page_num + 1) < gtk_notebook_get_n_pages (priv->notebook))
 627                         next_page_widget = gtk_notebook_get_nth_page (priv->notebook, current_page_num + 1);
 628
 629                 /* Ask the vfunc implementation whether navigation should be allowed: */
 630                 return (*(klass->before_next))(wizard_dialog, current_page_widget, next_page_widget);
 631         }
 632
 633         /* Allow navigation by default if there is no vfunc implementation: */
 634         return TRUE;
 635 }
 636
 637 static void
 638 invoke_enable_buttons_vfunc (ModestWizardDialog *wizard_dialog)
 639 {
 640         ModestWizardDialogClass *klass = MODEST_WIZARD_DIALOG_GET_CLASS (wizard_dialog);
 641
 642         /* Call the vfunc, which may be overridden by derived classes: */
 643         if (klass->enable_buttons) {
 644                 ModestWizardDialogPrivate *priv = MODEST_WIZARD_DIALOG(wizard_dialog)->priv;
 645
 646                 gint current_page_num = gtk_notebook_get_current_page (priv->notebook);
 647
 648                 GtkWidget* current_page_widget = gtk_notebook_get_nth_page (priv->notebook, current_page_num);
 649
 650                 (*(klass->enable_buttons))(wizard_dialog, current_page_widget);
 651         }
 652 }