MODIFY RECORD
MODIFY RECORD ( {aTable}{;}{*} )
| Parameter | Type | Description | |
|---|---|---|---|
| aTable | Table | → | Table to use for data entry, or Default table, if omitted |
| * | Operator | → | Hide scroll bars |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The MODIFY RECORD command modifies the current record for the table aTable or for the default table if you omit the aTable parameter. MODIFY RECORD loads the record, if it is not already loaded for the current process, and displays the current input form. If there is no current record, then MODIFY RECORD does nothing. MODIFY RECORD does not affect the current selection.
The form is displayed in the frontmost window of the process. The window has scroll bars and a size box. Specifying the optional * parameter causes the window to be drawn without scroll bars or a size box.
To use MODIFY RECORD, the current record must have read-write access and should not be locked.
If the form contains buttons for moving within the selection of records, MODIFY RECORD lets the user click the buttons to modify records and move to other records.
The record is saved (accepted) if the user clicks an Accept button or presses the Enter key (numeric key pad), or if the ACCEPT command is executed.
The record is not saved (canceled) if the user clicks a Cancel button or presses the cancel key combination (Ctrl-Period on Windows, Command-Period on Macintosh), or if the CANCEL command is executed. Even when canceled, the record remains in memory and can be saved if SAVE RECORD is executed before the current record pointer is changed.
After a call to MODIFY RECORD, OK is set to 1 if the record is accepted, to 0 if canceled.
Note: Even when canceled, the record remains in memory and can be saved if SAVE RECORD is executed before the current record pointer is changed.
If you are using MODIFY RECORD and the user does not change any of the data in the record, the record is not considered to be modified, and accepting the record does not cause it to be saved again. Actions such as changing variables, checking check boxes, and selecting radio buttons do not qualify as modifications. Only changing data in a field, either through data entry or through a method, causes the record to be saved.
Example
See example for the ADD RECORD command.
System variables and sets
Accepting the record sets the OK system variable to 1; canceling it sets the OK system variable to 0. The OK system variable is set only after the record is accepted or canceled.