REQUIREDWHEN keyword

Applies to

All component types

Description

Specifies the conditions under which a value for this component is required. If you reference variables, other components, or properties on collections on the form, WinStudio creates dependencies so that when those values change, the condition is automatically executed.

The keyword is stored in the format specification and not normally directly visible, because the keyword's contents are placed into the “Required When” field in the “Component” properties sheet. However if you are using the “Use Free Form” option, you must manually enter this keyword and its parameter values in the “Free Form Data Type” field.

Syntax

Use the “Edit Set of Conditional Actions” dialog box from the “Required When” field in the properties dialog to build the appropriate expression when creating an event handler of type Conditional Action.

Remarks

This keyword is used in expressions stored in the forms database. However, in most cases, you define the conditions for requiring the component by using the dialog box described above.