Dialog Box Script Actions - Symantec WISESCRIPT PACKAGE EDITOR 7.0 SP2 - FOR WISE INSTALLATION STUDIO V1.0 Installation Manual

Dialog Box Script Actions

WiseScript Package Editor Reference
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.
To create a custom dialog box script
Note
Before you write a custom dialog box script, review the introductory material in
Script Editor on page 22. Also see
Expressions on page 34.
1. Open the dialog box in the Custom Dialog Editor.
See Editing Dialog Boxes
2. Select View menu > Dialog Script Editor.
The Dialog Script Editor opens.
3. Create the script as you would in Script Editor.
The sample scripts Event Handler.wse and License Agreement.wse use scripting to
handle mouse events. For details on sample scripts, see ScriptHelp.htm in the Samples
subdirectory of this product's installation directory.
The script actions available in the Dialog Script Editor are a subset of the actions in
Script Editor, with the addition of these script actions that manipulate controls on the
dialog box programmatically: Set Control Attributes, Set Control Text, and Set Current
Control.
Call DLL Function on page 47
Check Configuration on page 52
Check If File/Dir Exists on page 56
Display Message on page 70
Edit INI File on page 72
Edit Registry on page 72
Else Statement on page 76
ElseIf Statement on page 76
End Statement on page 77
Get Registry Key Value on page 86
Get System Information
If Statement on page 91
Parse String on page 101
Prompt for Filename on page 103
Read INI Value on page 105
Remark on page 107
Conditions and Loops
on page 121.
on page 88
Creating Custom Dialog Boxes
About
on page 33 and Variables and
147