Events

#### Search Results

Search

# Events

Accessible Using

1. Select the "Events..." push button in an attributes window; or

2. "Dialog > Event Handlers" for dialog events; or

3. CTRL+ALT+E or SHIFT+ENTER for dialog events; or

4. "Control > Event Handlers" for a selected dialog element; or

5. CTRL+SHIFT+E or SHIFT+ENTER for a selected dialog element.

## Purpose

Enter Natural event handler code for those events that are provided for the dialog or dialog element; also allows you to enter event handler code for user-defined SEND EVENTs.

## Entries

Entry | Function
--- | ---
Event Name | This selection box lists the names of the system-provided events, such as the CLICK EVENT; it also lists the names of the user-written events that can be triggered by specifying SEND EVENT user-written-event-name. Please note that user-written-event-names are limited to 32 characters and that the option only applies to dialog events.
Editor | Invokes the program editor for the currently displayed event. Before using the program editor the dialog box must be closed using the 'OK' push button.
Rename | (Only applies to dialog events). This push button opens a dialog box where you can rename a user-written event.
New | (Only applies to dialog events). This push button opens a dialog box where you can enter the name of a new, user-written event.
Clear | (Only applies to dialog events). This push button opens a message box where you can specify whether you want to delete the code of a system-provided event or the code and the name of a user-written event.
Use | This push button opens a dialog box where you can select a subprogram or a subroutine by choosing an item from a list of objects or by entering the object name in the input field. Depending on whether it is a subprogram or a subroutine, you get a display of whether the CALLNAT or the PERFORM statement will be used. After having selected the subprogram or subroutine, you leave the dialog box by choosing OK. The subprogram or subroutine will be used by your current event handler code section. At the position where you left the event handler section, you will find the CALLNAT or PERFORM statement with the name of the object.
Suppress | Suppresses an event for which a corresponding SUPPRESS-eventname-EVENT attribute exists. The event is also suppressed if you leave the event handler section empty.
Event Info... | (Only applies to ActiveX control events): Provides information on the parameters of each event.
(Edit area) | Here you enter your Natural code that you want to be triggered when the event occurs.
OK | Saves the code (and name) of the event handler section and exits the dialog box.
Cancel | Exits the dialog box without saving the settings.
Help | Provides online help.

### On this page

- Purpose
- Entries