Waits for a dialog event.
The nextEvent() waits for a dialog event to occur, and returns a string that identifies the dialog event that has raised.
This method is typically used in a WHILE loop, to implement a dynamic dialog.
A dialog event can be a user-defined trigger such as "ON ACTION print", or an implicit trigger such as "BEFORE ROW", corresponding to the control blocks that can be defined in static dialog instructions such as DISPLAY ARRAY.
User-defined triggers are added to the dynamic dialog with the addTrigger() method:
| Trigger name | Description | Dialog block equivalent |
|---|---|---|
| ON ACTION action-name | Action handler for the action identified by action-name. | ON ACTION block |
| ON APPEND | Row addition action handler for a display array dynamic dialog. | ON APPEND block |
| ON DELETE | Row deletion action handler for a display array dynamic dialog. | ON DELETE block |
| ON INSERT | Row insertion action handler for a display array dynamic dialog. | ON INSERT block |
| ON UPDATE | Row modification action handler for a display array dynamic dialog. | ON UPDATE block |
Implicit dialog triggers are predefined and can be detected and handled in the dialog WHILE loop if needed:
| Trigger name | Description | Dialog block equivalent |
|---|---|---|
| BEFORE DISPLAY | Initialization of the display array dynamic dialog. | BEFORE DISPLAY block |
| BEFORE INPUT | Initialization of the input by name dynamic dialog. | BEFORE INPUT block |
| AFTER DISPLAY | End of the display array dynamic dialog. | AFTER DISPLAY block |
| AFTER INPUT | End of the input by name dynamic dialog. | AFTER INPUT block |
| BEFORE ROW | Moving to a new row in a display array dynamic dialog. | BEFORE ROW block |
| AFTER ROW | Leaving the current row in a display array dynamic dialog. | AFTER ROW block |
| BEFORE FIELD field-name | Entering the field field-name in an input dynamic dialog. | BEFORE FIELD block |
| AFTER FIELD field-name | Leaving the field field-name in an input dynamic dialog. | AFTER FIELD block |