Description
Clears the form.
Syntax
bforward = CLEAR (ctrlentID, ctrlclassID, bsavekey, bsuppresswarning, bmaintainfocus)
Parameters
CLEAR accepts arguments for the following parameters.
| Parameter | Description |
|---|---|
| CtrlentID | Has the format WindowName.ControlName, where WindowName is the identifier of the window that contains the affected control, and ControlName is the identifier of the control. Notice that a period separates the two values. |
| CtrlclassID | The type of control that recognizes the event. The window control type is the only valid entry. |
| Bsavekey | If true, do not clear controls based on key parts. |
| bsuppresswarning | If true, then suppress warning about saving changes. |
| bmaintainfocus | If true, then maintain focus on the control which currently has it. If false, focus goes to the bound control key field. |
Returns
True or false. If false, the program execution returns to the calling procedure. If true, the event processing goes to the next level.
Remarks
The CLEAR event is automatically sent in the following situations:
1. On READ, if the row is locked and the user chooses not to view it
2. On READ, if the read fails for any other reason
3. On WRITE, if the "Clear Form after Write" option is set
4. On WRITE, if the row exists and is locked and the user chooses not to overwrite the row
5. On successful DELETE processing
