hildon 1.0.17 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" gchararray : Read / Write "wizard-notebook" GtkNotebook : Read / Write
HildonWizardDialog is a widget to create a guided installation process. The dialog has four standard buttons, previous, next, finish, cancel, and contains several pages with optional icons. Response buttons are dimmed/undimmed automatically and the standard icon is shown/hidden in response to page navigation. The notebook widget provided by users contains the actual wizard pages.
Using 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 finnish. 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 = 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" gchararray : Read / Write
The name of the wizard.
Default value: NULL