Creating A Custom Dialog Box Script - Symantec WISESCRIPT EDITOR 7.0 SP2 - FOR WISE INSTALLATION EXPRESS V1.0 Installation Manual

Creating a Custom Dialog Box Script

WiseScript Editor Reference
2. Select Edit menu > Dialog Set Properties.
The Dialog Set Properties dialog box appears.
3. Complete the dialog box:
Dialog Set Name
Enter the name of this dialog box set. If this dialog box set is comprised of only
one dialog box, then this is usually the same name as the dialog box. The name
must be unique within a wizard loop. This value is displayed in the installation
script.
Display Variable
The display variable determines which dialog box in the wizard loop to present
to the end user the next time the wizard loop is executed. When this dialog box
is presented to the end user, the display variable is set to this dialog box set
name. If this field is not blank, the dialog box is only displayed if the variable
holds the same value as the Dialog Set Name field.
Called Dialogs Float
If you are displaying a dialog box outside a wizard loop, mark this check box to
have called dialog boxes appear in front of the calling dialog box. (Example:
Suppose you display a Select Destination Directory dialog box that contains a
Browse button. If this check box is marked, and the end user clicks Browse, the
Browse dialog box appears in front of the Select Destination Directory dialog
box instead of replacing it.) This behavior is built into the wizard loop dialog
boxes by default.
4. Click OK.
Each dialog box can include an attached WiseScript that lets you perform script actions
in response to events inside a dialog box. You create this WiseScript in the Dialog Script
Editor, which is a scaled-down version of Script Editor. It contains only those script
actions that can be used in dialog box scripts. It lets you script dialog boxes to handle
mouse movements, gather user input, and branch according to end user choices.
Events are generated as the end user works with the dialog box on the destination
computer. Built-in dialog box events include first-time display of the dialog box (INIT),
updating of information displayed on the dialog box (UPDATE), and verification of the
validity of the contents of the dialog box (VERIFY). Additional events, whose names you
define, can be generated by marking the Execute Named Event option on the settings
dialog box of push button or hot text controls.
To handle the generated events, you create a conditional structure in the dialog box
script that tests the variable DLG_EVENT_TYPE for the appropriate value. (Example: If
DLG_EVENT_TYPE is equal to INIT, the INIT event is being called.) The script actions
between the If statement that tests for this value and the End statement that goes with
it should handle that event. The script can handle multiple events in different ways by
including multiple conditional blocks, one after the other.
Creating Custom Dialog Boxes
144