====== CLEAR event ======


 
==== 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:
  - On READ, if the row is locked and the user chooses not to view it
  - On READ, if the read fails for any other reason
  - On WRITE, if the "Clear Form after Write" option is set
  - On WRITE, if the row exists and is locked and the user chooses not to overwrite the row
  - On successful DELETE processing