Version 6.3.8 for Windows
 —  Dialog Component Reference  —

Leave Event

This document covers the following topics:


Applies To

Dialog, ActiveX Controls, Column Specification Control, Date and Time Picker (DTP) Control, Edit Area Control, Input Field Control, Selection Box Control, Tab Control Tab, Table Control.

Top of page

Description

Occurs whenever the dialog or dialog element loses the focus. You can use the leave event handler to validate field entries or to dynamically modify other dialog elements whose status depends on that of the dialog element just left. Does not occur on closing a dialog.

For table controls, this event occurs if the end user leaves a row or if the table loses the focus. If the end user leaves a cell, the leave-cell event occurs.

If this event occurs in a cell of a Table Control, the ROW and COLUMN attributes are modified so that they contain the position of the cell.

Before this event handler code is processed, end user input in (linked variable) input-field controls and selection-box controls is checked against any EDIT-MASK value or applicable Natural data type. However, in the following situations the leave event is not triggered after end user input was checked and a linked variable was updated:

Note:
It is not recommended to execute the PROCESS GUI statement action SET-FOCUS from the leave event because the leave event implies that the focus is to be set to yet another part of the application.

Top of page