259. Wizard

Wizard dialog

259.1. Summary of Module Globals

List of Global Functions

List of Global Variables

    259.2. Global Functions

    259.2.1. AbortAcceptButtonBox

    Returns a button box with buttons "Abort", "Accept"

    Return value

    • term - a widget tree

    259.2.2. AbortApplyFinishButtonBox

    Returns a button box with buttons "Abort", "Apply", "Finish"

    Return value

    • term - a widget tree

    259.2.3. AbortInstallationAcceptButtonBox

    Returns a button box with buttons "Abort Installation", "Accept"

    Return value

    • term - a widget tree

    259.2.4. AcceptDialog

    Returns a standard wizard dialog with buttons "Cancel", "Accept"

    Return value

    • term - describing the dialog.

    259.2.5. AddMenu

    Add Menu

    Function parameters

    • list<map> Menu

    • string title

    • string id

    Return value

    • list<map> - Updated Menu Data

    259.2.6. AddMenuEntry

    Add Menu Entry

    Function parameters

    • list<map> Menu

    • string parent_id

    • string title

    • string id

    Return value

    • list<map> - Updated Menu Data

    259.2.7. AddSubMenu

    Add Sub Menu

    Function parameters

    • list<map> Menu

    • string parent_id

    • string title

    • string id

    Return value

    • list<map> - Updated Menu Data

    259.2.8. AddTreeItem

    Add Tree Item to tree enabled Wizard

    Function parameters

    • list<map> Tree

    • string parent

    • string title

    • string id

    Return value

    • list<map> - Updated Tree Data

    259.2.9. BackAbortInstallationNextButtonBox

    Returns a button box with buttons "Back", "Abort Installation", "Next"

    Return value

    • term - a widget tree

    259.2.10. BackAbortNextButtonBox

    Returns a button box with buttons "Back", "Abort", "Next"

    Return value

    • term - a widget tree

    259.2.11. BackNextButtonBox

    Returns a button box with buttons "Back", "Next"

    Return value

    • term - a widget tree

    259.2.12. CancelAcceptButtonBox

    Returns a button box with buttons "Cancel", "Accept"

    Return value

    • term - a widget tree

    259.2.13. ClearContents

    Clear the wizard contents.

    Return value

    • void

    259.2.14. ClearTitleIcon

    Clear the wizard 'title' icon, i.e. replace it with nothing

    Return value

    • void

    259.2.15. CloseDialog

    Close a wizard dialog.

    Return value

    • void

    259.2.16. CreateDialog

    Create and open a typical installation wizard dialog.

    Return value

    • void

    259.2.17. CreateMenu

    Create the menu in the dialog

    Function parameters

    • list<map> Menu

    Return value

    • void

    259.2.18. CreateTree

    Create the tree in the dialog, replaces helpspace with new tree widget

    Function parameters

    • list<map> Tree

    • string title

    Return value

    • void

    259.2.19. CreateTreeDialog

    Create and open a Tree wizard dialog.

    Return value

    • void

    259.2.20. DeleteMenus

    Delete Menu items

    Return value

    • void

    259.2.21. DeleteTreeItems

    Delete Tree items

    Return value

    • void

    259.2.22. DisableAbortButton

    Disable the wizard's "Abort" button.

    Return value

    • void

    259.2.23. DisableBackButton

    Disable the wizard's "Back" button.

    Return value

    • void

    259.2.24. DisableCancelButton

    Disable the wizard's "Cancel" button.

    Return value

    • void

    259.2.25. DisableNextButton

    Disable the wizard's "Next" (or "Accept") button.

    Return value

    • void

    259.2.26. EnableAbortButton

    Enable the wizard's "Abort" button.

    Return value

    • void

    259.2.27. EnableBackButton

    Enable the wizard's "Back" button.

    Return value

    • void

    259.2.28. EnableCancelButton

    Enable the wizard's "Cancel" button.

    Return value

    • void

    259.2.29. EnableNextButton

    Enable the wizard's "Next" (or "Accept") button.

    Return value

    • void

    259.2.30. GenericDialog

    Create a Generic Dialog

    Function parameters

    • term button_box

    Return value

    • term - term describing the dialog.

    259.2.31. HideAbortButton

    Hide the Wizard's "Abort" button. Restore it later with RestoreAbortButton():

    Return value

    • void

    259.2.32. HideBackButton

    Hide the Wizard's "Back" button. Restore it later with RestoreBackButton():

    Return value

    • void

    259.2.33. HideNextButton

    Hide the Wizard's "Next" button. Restore it later with RestoreNextButton():

    Return value

    • void

    259.2.34. HideReleaseNotesButton

    Hide the "Release Notes" button, if there is any

    Return value

    • void

    259.2.35. IsWizardDialog

    Check if the topmost dialog is a wizard dialog (i.e. has a widget with `id(`WizardDialog) )

    Return value

    • boolean - True if topmost dialog is a wizard dialog, false otherwise

    259.2.36. NextBackDialog

    Returns a standard wizard dialog with buttons "Next", "Back", "Abort".

    Return value

    • term - describing the dialog.

    259.2.37. OpenAbortApplyFinishDialog

    Open a dialog with "Accept", "Cancel" and set the keyboard focus to "Accept".

    Return value

    • void

    259.2.38. OpenAcceptAbortStepsDialog

    Open a dialog with "Accept", "Cancel" that will also accept workflow steps.

    Return value

    • void

    259.2.39. OpenAcceptDialog

    Open a dialog with "Accept", "Cancel" and set the keyboard focus to "Accept".

    Return value

    • void

    259.2.40. OpenAcceptStepsDialog

    Open a dialog with "Accept", "Cancel" that will also accept workflow steps.

    Return value

    • void

    259.2.41. OpenCustomDialog

    Open a wizard dialog with simple layout

    Function parameters

    • term help_space_contents

    • term button_box

    Return value

    • void

    259.2.42. OpenDialog

    Open any wizard dialog.

    Function parameters

    • term dialog

    Return value

    • void

    259.2.43. OpenNextBackDialog

    Open a dialog with buttons "Next", "Back", "Abort" and set the keyboard focus to "Next".

    Return value

    • void

    259.2.44. OpenNextBackStepsDialog

    Open a dialog with "Back", "Next", "Abort" that will also accept workflow steps.

    Return value

    • void

    259.2.45. OpenTreeNextBackDialog

    Open a Tree dialog with buttons "Next", "Back", "Abort" and set the keyboard focus to "Next".

    Return value

    • void

    259.2.46. QueryTreeItem

    Query Tree Item

    Return value

    • string - Tree Item

    259.2.47. ReplaceAbortButton

    Replace the wizard 'abort' button with a custom widget. THIS FUNCTION IS DEPRECATED!

    Function parameters

    • term contents

    Return value

    • void

    259.2.48. ReplaceBackButton

    Replace the wizard 'back' button with a custom widget. THIS FUNCTION IS DEPRECATED!

    Function parameters

    • term contents

    Return value

    • void

    259.2.49. ReplaceCustomHelp

    Replace the help widget for dialogs opened with Wizard::OpenCustomDialog().

    Function parameters

    • term contents

    Return value

    • void

    259.2.50. ReplaceHelp

    Replace the wizard help subwindow with a custom widget.

    Function parameters

    • term contents

    Return value

    • void

    259.2.51. ReplaceNextButton

    Replace the wizard 'next' button with a custom widget. THIS FUNCTION IS DEPRECATED!

    Function parameters

    • term contents

    Return value

    • void

    259.2.52. RestoreAbortButton

    Restore the wizard 'abort' button.

    Return value

    • void

    259.2.53. RestoreBackButton

    Restore the wizard 'back' button.

    Return value

    • void

    259.2.54. RestoreHelp

    Restore the wizard help subwindow.

    Function parameters

    • string help_text

    Return value

    • void

    259.2.55. RestoreNextButton

    Restore the wizard 'next' button.

    Return value

    • void

    259.2.56. RestoreScreenShotName

    Restore the screenshot name.

    Return value

    • void

    259.2.57. RetranslateButtons

    Retranslate the wizard buttons.

    Return value

    • void

    259.2.58. SelectTreeItem

    Select Tree item

    Function parameters

    • string tree_item

    Return value

    • void

    259.2.59. SetAbortButton

    Set the dialog's "Abort" button with a new label and a new ID

    Function parameters

    • any id

    • string label

    Return value

    • void

    259.2.60. SetBackButton

    Set the dialog's "Back" button with a new label and a new ID

    Function parameters

    • any id

    • string label

    Return value

    • void

    259.2.61. SetContents

    Set the contents of a wizard dialog

    Function parameters

    • string title

    • term contents

    • string help_text

    • boolean has_back

    • boolean has_next

    Return value

    • void

    259.2.62. SetContentsButtons

    Set contents and Buttons of wizard dialog

    Function parameters

    • string title

    • term contents

    • string help_text

    • string back_label

    • string next_label

    Return value

    • void

    259.2.63. SetDesktopIcon

    Set Desktop Icon

    Function parameters

    • string file

    Return value

    • boolean - true on success

    259.2.64. SetFocusToBackButton

    Set the keyboard focus to the wizard's "Back" (or "Cancel") button.

    Return value

    • void

    259.2.65. SetFocusToNextButton

    Set the keyboard focus to the wizard's "Next" (or "Accept") button.

    Return value

    • void

    259.2.66. SetHelpText

    Set a new help text.

    Function parameters

    • string help_text

    Return value

    • void

    Example 75. 

     Wizard::SetHelpText("This is a help Text");


    259.2.67. SetNextButton

    Set the dialog's "Next" button with a new label and a new ID

    Function parameters

    • any id

    • string label

    Return value

    • void

    259.2.68. SetProductName

    Set the product name for UI

    Function parameters

    • string name

    Return value

    • void

    259.2.69. SetScreenShotName

    Declare a name for the current dialog

    Function parameters

    • string s

    Return value

    • void

    259.2.70. SetTitleIcon

    Set the wizard 'title' icon

    Function parameters

    • string icon_name

    Return value

    • void

    259.2.71. ShowHelp

    Open a popup dialog that displays a help text (rich text format).

    Function parameters

    • string help_text

    Return value

    • void

    259.2.72. ShowReleaseNotesButton

    Show a "Release Notes" button with the specified label and ID if there is a "steps" panel

    Function parameters

    • string label

    • any id

    Return value

    • void

    259.2.73. UserInput

    Substitute for UI::UserInput

    Return value

    • any - (maybe normalized) widget ID

    259.3. Global Variables

    259.4. Module Requirements

    259.4.1. Module Imports

    • Directory
    • Label
    • Popup
    • SuSERelease

    259.4.2. Module Includes