Event Handler Parameters
Use this form to set error messages and other specifications for a form event handler.
This form consists of two sections: The top section is common to all form event response types. The bottom section varies according to the Response > Type that is chosen on the Event Handlers tab of the Details panel.
The top section, common to all form event response types includes these fields and options (all of which are optional):
Field/Option | Description |
---|---|
Error Message | Enter the message to be displayed when the event handler returns an error. You can include translatable string names and any of the Windows client substitution keywords. |
Success Message | Enter the message to be displayed when the event handler succeeds. You can include string names and any of the Windows client substitution keywords. |
Only When Current Collection Is | Select the name of the collection to which this event handler
applies. Normally, event handlers execute regardless of the currently active collection or the specific collection operation that generated the event. Use this option when you want the event to be generated only if the designated collection is the active collection. |
Only When Platform Is | Select the name of the platform ( Normally, event handlers execute regardless of the currently active platform. |
=Windows, , or )
to which this event handler applies.
KEEP | Select the attribute that will be applied to the KEEP parameter of the event handler:
|
Ignore Failure | Select this option to classify any result returned by this event
handler as a success. Use this setting if you want subsequent event
handlers to continue to execute even if this event handler returned a
failure. Otherwise, clear this check box. Use this setting if you want the failure of this event handler to stop the execution of subsequent event handlers. |
Message on Status Line? | Select this option to display the error and success messages in the
application’s Status bar. To have these messages display in a pop-up dialog box, clear this option. |
Disabled | Select this option to temporarily disable the event handler. Windows client does not run a disabled event handler,
even if its other execution criteria are satisfied. To re-enable the event handler, clear this option. |
For the fields and options associated with the various response types, see these topics: