Sign in Join
FPDoc Onlineexperiment

TControl.InvalidateControl procedure

Member of TControlprotectedIn unit Controls

Requests a repaint of the control.

Declaration

pascal
procedure InvalidateControl(CtrlIsVisible: Boolean; 
 CtrlIsOpaque: Boolean)
procedure InvalidateControl(CtrlIsVisible: Boolean; 
 CtrlIsOpaque: Boolean; 
 IgnoreWinControls: Boolean)

Arguments

CtrlIsVisibleTrue if the control is visible.
CtrlIsOpaqueTrue if the control use an opaque drawing style.
IgnoreWinControlsTrue if TWinControl descendants are ignored in the method.

Description

InvalidateControl is an overloaded method used to redraw the bounds rectangle for control. No actions are performed in the method if the Parent control or its Handle are not assigned, during LCL component streaming, or when the control is being freed.

When CtrlIsVisible is set to True or the control has a visible design surface, the InvalidateRect routine is called. The BoundsRect for the control is erased and redrawn when the control uses an opaque drawing style, or when it occludes a sibling control in its Parent.

InvalidateControl is called from methods like Invalidate and ChangeBounds, and when a new value is assigned to the Visible property.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.