hildon 2.1.24 Reference Manual | ||||
---|---|---|---|---|
enum HildonWizardDialogResponse; HildonWizardDialog; GtkWidget* hildon_wizard_dialog_new (GtkWindow *parent, const char *wizard_name, GtkNotebook *notebook);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----HildonWizardDialog
"autotitle" gboolean : Read / Write "wizard-name" gchar* : Read / Write "wizard-notebook" GtkNotebook* : Read / Write
HildonWizardDialog is a widget to create a guided installation process. The dialog has three standard buttons, previous, next, finish, and contains several pages.
Response buttons are dimmed/undimmed automatically. The notebook widget provided by users contains the actual wizard pages.
Usage of the API is very simple, it has only one function to create it and the rest of it is handled by developers notebook. Also, the response is returned, either cancel or finish. Next and previous buttons are handled by the wizard dialog it self, by switching the page either forward or backward in the notebook.
typedef enum { /* HILDON_WIZARD_DIALOG_CANCEL should be marked as deprecated */ HILDON_WIZARD_DIALOG_CANCEL = GTK_RESPONSE_CANCEL, HILDON_WIZARD_DIALOG_PREVIOUS = 0, HILDON_WIZARD_DIALOG_NEXT, HILDON_WIZARD_DIALOG_FINISH } HildonWizardDialogResponse;
GtkWidget* hildon_wizard_dialog_new (GtkWindow *parent, const char *wizard_name, GtkNotebook *notebook);
Creates a new HildonWizardDialog.
parent : |
a GtkWindow |
wizard_name : |
the name of dialog |
notebook : |
the notebook to be shown on the dialog |
Returns : | a new HildonWizardDialog |
"autotitle"
property"autotitle" gboolean : Read / Write
If the wizard should automatically try to change the window title when changing steps. Set to FALSE if you'd like to override the default behaviour.
Default value: TRUE
Since 0.14.5
"wizard-name"
property"wizard-name" gchar* : Read / Write
The name of the wizard.
Default value: NULL