ACCEPT
ACCEPT
| Does not require any parameters |
|---|
This command is not thread-safe, it cannot be used in preemptive code.
Description
The ACCEPT command is used in form or object methods (or in subroutines) to:
- accept a new or modified record, for which data entry has been initiated using ADD RECORD or MODIFY RECORD.
- accept a form displayed with the DIALOG command.
- exit a form displaying a selection of records, using DISPLAY SELECTION or MODIFY SELECTION.
ACCEPT performs the same action as if a user had pressed the Enter key. After the form is accepted, the OK system variable is set to 1.
ACCEPT is commonly executed as a result of choosing a menu command. ACCEPT is also commonly used in the object method of a “no action” button.
It is also often used in the optional close box method for the Open window command. If there is a Control-menu box on a window, ACCEPT or CANCEL can be called, in the method to be executed, when the Control-menu box is double-clicked or the Close menu command is chosen.
ACCEPT cannot be queued up. In response to an event, executing two ACCEPT commands in a row from within a method would have the same effect as executing one.
Headless mode
The ACCEPT command is allowed in headless mode, in the context of offscreen areas created by VP Run offscreen area or WA Run offscreen area.