Xbasic

UI_FREEZE Function

Syntax

V UI_FREEZE(L freeze_screen)

Arguments

freeze_screen

.T. = Prevent the screen from updating while a script is running. .F. = Allow the screen to update while a script is running.

Description

Turns off/on screen repainting.

Discussion

UI_FREEZE() freezes (i.e., prevents the screen from updating) the screen if Flag is .T. while a script is running. If Flag is .F., allows the screen to be updated. Use this command to prevent unnecessary redraws of the screen, or screen flashing, while a script is running.

Example 

The following script advances to the next record in a browse.

ui_freeze(.T.)
browse1.fetch_next()
ui_freeze(.f.)

Limitations

Desktop applications only.

See Also