Using Navigation Buttons on Wizard Pages
InstallShield 2022
Project:This information applies to the following project types:
| • | Advanced UI |
| • | Suite/Advanced UI |
Edition:The Advanced UI project type is available in the InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.
Each wizard page in an Advanced UI or Suite/Advanced UI project can have one or more of the following built-in navigation buttons:
|
Button |
Description of Default Behavior |
|
Next |
Move to the next wizard page in the interface, skipping any pages whose Visible conditions evaluate to false. Clicking this button has no effect if the current wizard page is the last page in the interface. The Next navigation button behaves similarly to controls that use a Set Active Page action, which triggers a move to a specific page. |
|
Back |
Move to the previous wizard page in the interface, skipping any pages whose Visible conditions evaluate to false. Clicking this button has no effect if the current wizard page is the first page in the interface. The Back navigation button behaves similarly to controls that use a Set Active Page action, which triggers a move to a specific page. |
|
Cancel |
Display a message box with question IDS_SUITE_CONFIRMCANCEL; on Yes, cancel the wizard and move to the last wizard page. In most cases, the last wizard page should not show a Cancel button, since cancelling the installation at that point does not have any effect. If a Cancel button is displayed, clicking it would result in closing the wizard. |
|
Install |
Start the installation and move to the next wizard page. The Install navigation button behaves similarly to controls that use an Install action, which start the installation and then move to a specific wizard page. |
|
Finish |
After a successful installation or maintenance, if a restart is required, ask whether to restart (message IDS_SUITE_ASKREBOOT), and then trigger the appropriate response. In either case (required or not required, immediate restart or delayed restart), close the wizard. |
Including a Navigation Button on or Excluding It from a Wizard Page
When you select a wizard page in the Wizard Interface view of an Advanced UI or Suite/Advanced UI project, the grid on the right side of the view shows the settings for the selected page. The Navigation area settings let you configure the navigation buttons for the page.
To include or exclude a navigation button:
| 1. | In the View List under User Interface, click Wizard Interface. |
| 2. | In the Wizard Interface explorer, click the wizard page whose buttons you want to modify. |
| 3. | In the Navigation area of the grid on the right side of the view, do the following: |
| • | To include a specific button on the wizard page, select Yes in that button’s setting, and then configure the subsettings under that button’s setting as needed. |
| • | To exclude a specific button from a wizard page, select No in that button’s setting, and then configure the subsettings under that button’s setting as needed. |
To learn about changing the default behavior of navigation buttons, see Overriding the Default Behavior of a Navigation Button on a Wizard Page.
See Also