User-Defined Events

This document covers the following topics:


Apply To

Dialog.

Description

User-defined events occur whenever you have specified a SEND EVENT statement with the name of a previously undefined event in an event handler code of a dialog.

Note:
The user event must be defined in another dialog than the one where it occurs. For more details and examples of how to cause an action to occur in another dialog, see the section Triggering User-Defined Events in Event-driven Programming Techniques documentation.

You can define user events for dialogs by pressing the "New" button in the "Events..." dialog box of the dialog's attributes window. You can then enter any name of your newly-defined user event and specify the corresponding event section. It is recommend that you use "#" as the first letter to distinguish user-defined events from previously defined events.

If no event handler is defined for an event generated by the SEND EVENT statement, the default event handler is executed with the value of the system variable *EVENT as the user event name.