Action Statement
Control use of window handles.
make {DB_NAME|DR_NAME} {permanent|temporary}
DB_NAME
The identifier for a dialog box.
DR_NAME
The identifier for a dialog region.
Description
Use this statement to control ESL's use of window handles for dialog boxes, dialog regions, and their controls.
When an invisible object is made temporary, its physical Windows handle is deleted and the state of any of its controls is lost.
If you want to use inquiry functions on an invisible dialog box or dialog region, make the object permanent before making it invisible. To reduce the number of windows, make an object temporary and invisible once its information is no longer needed.
Note that using the make permanent or make temporary action overrides the initial specification used during creation of the dialog region or dialog box. The dialog region or dialog box will retain the permanent or temporary characteristic specified in the make action, regardless of the intial state of the dialog region or dialog box.
When a temporary and invisible object is made visible again, you cannot rely on the values of the attributes of the object or its dialog controls. If you want to redisplay a temporary and invisible object, reset the attribute values after the object is made visible or permanent. To avoid momentary display of incorrect values, you can make the object permanent, then set the attributes, and then make the object visible.
If a make permanent or make temporary action statement references an object that does not exist, the following error results:
error changing object permanency: object OBJ_NAME not found.
If you try to reference a dialog control that is inside an invisible temporary dialog box or dialog region through functions such as text of OBJECT, the following error results:
error getting value - window handle of object not found
Example
response to Cancel
make DialogBox1 permanent
response to UpdateComplete
make DialogBox1 temporary
See Also
dialog box Definition
dialog region Definition
