Event Handler Parameters - Edit Generate Application Event Parameters

This version of the Event Handler Parameters form is used with form events that have been assigned a Response > Type of Generate Application Event.

Field/Option Description
Event This required field specifies the name of an application event defined in the Events form.

Only custom, non-framework events can be specified.

Synchronous With this option is selected, form processing is suspended until the Application Event System executes its event handlers.

Output values returned by handlers for the application event can be processed into form components, variables, or properties, as specified in parameter Value settings. Any updated components and properties are marked as modified.

If you clear this check box, no processing of output parameters occurs in the form. The form continues to execute after the event is generated, allowing the application event system to operate in parallel with Windows client.

Name This field specifies the name of a parameter defined for the event in the Application Event System.

To return the result of a synchronous event to the form component, variable, or property specified in the Value field, enter the keyword RESULT.

Value This field specifies the value to be used for the parameter.

Windows client substitution keywords and literals are supported as parameter values.

To add or edit a literal value or a component, variable, or property value, click Edit Parameter.

If Synchronous is selected and a parameter with the same name is defined as an output parameter in an application event handler, output values can update form components, variables, or properties. To enable updates of this type, use the substitution keywords C(ComponentName), V(VariableName), or P(PropertyName) as values. Event handler output from such parameters is placed in the named components, variables, or properties.

New Parameter Click to create a new row in the Parameters grid.

To specify a new parameter, enter a Name, and then enter a Value or click Edit Parameter to specify a Value.

Delete Parameter Click to delete the current row in the Parameters grid.
Edit Parameter Click to edit the Value in the current row in the Parameters grid.