User Tools

Site Tools


unfreeze_resume_control_drawing_.htm
Navigation:  Language Reference > 13 - Built-in Functions >====== UNFREEZE (resume control drawing) ====== Previous pageReturn to chapter overviewNext page

NewC7.jpg

UNFREEZE( feq , state )

blk2blue.jpg

Returns LONG value used to pass to the corresponding UNFREEZE pairing.

UNFREEZE Resume control redrawing
feq The SIGNED field equate label representing the control that you wish to affect..
state The LONG value returned by the last FREEZE for that control that has not been closed.

UNFREEZE resumes redrawing of the control of current thread's top window with passed feq previously suspended by FREEZE. The second state parameter is a value returned by last FREEZE for that control which has not been closed by paired UNFREEZE.

FREEZE and UNFREEZE are useful in certain situations where you wish to delay a control's redraw operation. For example:

·Dynamically changing several properties of the same control, each of which can alter its visibility, (e.g. font name, size and style)

·Performing multiple search-and-replace operations on an RTF control.

Calls to FREEZE can be nested. Every call must have its paired UNFREEZE. FREEZE and UNFREEZE functions must be used with accuracy; if there is no paired call to UNFREEZE for an executed FREEZE, the control cannot be redrawn and thus the screen can be displayed incorrectly.

If a control can be redrawn after UNFREEZEing (e.g., there are no other unclosed calls to FREEZE, the control is visible, etc.), the UNFREEZE function forces redrawing of the control.


Use with Menu controls

FREEZE/UNFREEZE can be used for Menu controls,  but the feq parameter for a Menu control must use the special value 10001h, or the EQUATE “Freeze:MenuBar” (defined in EQUATES.CLW).

Example:

x1# = FREEZE (feq)

x2# = FREEZE (feq)

UNFREEZE (feq, x2#)

UNFREEZE (feq, x1#)

See also: FREEZE

unfreeze_resume_control_drawing_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)