Button States
Wizard allows total control over its button visibility and enabled states at both a global wizard level and at a page-specific override level.
Global settings made on the Wizard control are default settings for all contained pages. Settings made on a WizardPage can choose to inherit the global Wizard settings or override them with page-specific settings. The page-specific settings take effect while that particular page is selected.
These settings are used by the Wizard command model to determine whether the associated commands should be enabled. See that topic for more information on how to use the commands.
Wizard Global Default Button State Settings
These Wizard properties are used as the default settings for all pages within the Wizard:
| Member | Description |
|---|---|
| HelpButtonVisible Property | A Boolean that indicates whether the Help button is visible. |
| CancelButtonVisible Property | A Boolean that indicates whether the Cancel button is visible. |
| BackButtonVisible Property | A Boolean that indicates whether the Back button is visible. |
| NextButtonVisible Property | A Boolean that indicates whether the Next button is visible. |
| FinishButtonVisible Property | A Boolean that indicates whether the Finish button is visible. |
| HelpButtonEnabled Property | A Boolean that indicates whether the Help button is enabled. |
| CancelButtonEnabled Property | A Boolean that indicates whether the Cancel button is enabled. |
| BackButtonEnabled Property | A nullable Boolean that indicates whether the Back button is enabled. A true or false value sets the Wizard default. Specifying null uses the enabled logic for the PreviousPage command as described in the command model topic. |
| NextButtonEnabled Property | A nullable Boolean that indicates whether the Next button is enabled. A true or false value sets the Wizard default. Specifying null uses the enabled logic for the NextPage command as described in the command model topic. |
| FinishButtonEnabled Property | A nullable Boolean that indicates whether the Finish button is enabled. A true or false value sets the Wizard default. Specifying null uses the enabled logic for the Finish command as described in the command model topic. |
WizardPage Instance Button State Settings
These WizardPage properties are used as page-specific settings that may override the Wizard global settings:
| Member | Description |
|---|---|
| HelpButtonVisible Property | A nullable Boolean that indicates whether the Help button is visible. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| CancelButtonVisible Property | A nullable Boolean that indicates whether the Cancel button is visible. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| BackButtonVisible Property | A nullable Boolean that indicates whether the Back button is visible. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| NextButtonVisible Property | A nullable Boolean that indicates whether the Next button is visible. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| FinishButtonVisible Property | A nullable Boolean that indicates whether the Finish button is visible. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| HelpButtonEnabled Property | A nullable Boolean that indicates whether the Help button is enabled. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| CancelButtonEnabled Property | A nullable Boolean that indicates whether the Cancel button is enabled. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| BackButtonEnabled Property | A nullable Boolean that indicates whether the Back button is enabled. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| NextButtonEnabled Property | A nullable Boolean that indicates whether the Next button is enabled. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
| FinishButtonEnabled Property | A nullable Boolean that indicates whether the Finish button is enabled. A true or false value overrides the Wizard default. Specifying null uses the Wizard default. |
Setting At Run-Time
All of these properties may be changed at run-time programmatically to update the user interface button states.