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]

Return Value

  • 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

Applies To: Form Object | _SCREEN System Variable | ToolBar Object

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

Reference

Paint Event

Other Resources

Properties (Visual FoxPro)