LockScreen Property

Determines whether a form batches all changes to property settings for its contained objects. Available at design time and run time.

Object.LockScreen[ = lExpr]

Property Values

  • lExpr
    The settings for the LockScreen property are:
    Setting Description
    True (.T.) The form's contained objects reflect changes in property settings only when LockScreen is reset to false (.F.) rather than as soon as the changes are made.
    False (.F.) (Default) The form's contained objects reflect changes in property settings as soon as the changes are made.

Remarks

Set LockScreen to true (.T.) to reduce annoying screen refreshes when presentation properties such as BackColor, FontName, and so on are changed during run time.

The LockScreen property does not prevent changes to the form from being reflected immediately. For example, even if LockScreen is set to true, the form is moved if you call its Move method.

Note   If you set LockScreen to false (.F.), the form's contained controls are repainted immediately.

See Also

Paint Event

Applies To: Form | _SCREEN | ToolBar