Form Begin
Scope
- Simulation content object > Form Begin macro
Purpose
The Form Begin macro identifies the start of a set of input macros (and a Mouse Action or Key-Stroke macro) that are to be presented to the user (in Practice mode and Test mode) at the same time, and with a single Bubble. There must be a corresponding Form End macro within the same Step that identifies the end of the set.
A Form Structure allows users to complete all of the input fields within the Form Structure in any order. Validation of the users input will not be performed until a Mouse Action or Key-Stroke within the Form Structure is executed. You can have multiple Mouse Action macros and/or multiple Key-Stroke macros within the Form Structure, and these can be in any order (including before or inbetween the input macros), but the user will only need to perform one of these to validate their input and continue.
Use
To insert a Form Structure, click on the Step within which you want to insert the Form Structure, and then select menu option Insert > Insert Special Macro > Insert Form Structure. A Form Begin macro is inserted into the Step immediately after the Screen macro, and a Form End macro is inserted as the last macro in the Step, so that all other macros fall between these two macros. You can drag macros in and out of the Form Structure, but ultimately the Form Structure must contain a number of input macros (Input Text, Select Single, Radio/Checkbox, Key-Stroke) and a single Mouse Action macro. Do not include any Explanation macros within the Form Structure as these will interfere with its functioning.
Properties
See Also
- Simulation content object > Form End macro
