Control.Invalidate Method (Boolean) (System.Windows.Forms)

Switch View :

ScriptFree

.NET Framework Class Library

Control.Invalidate Method (Boolean)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic


Public Sub Invalidate ( _
	invalidateChildren As Boolean _
)


public void Invalidate(
	bool invalidateChildren
)

Visual C++


public:
void Invalidate(
	bool invalidateChildren
)


member Invalidate : 
        invalidateChildren:bool -> unit

Parameters

invalidateChildren: Type: System.Boolean
true to invalidate the control's child controls; otherwise, false.

Remarks

Calling the Invalidate method does not force a synchronous paint; to force a synchronous paint, call the Update method after calling the Invalidate method. When this method is called with no parameters, the entire client area is added to the update region.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Control Class

Invalidate Overload

System.Windows.Forms Namespace

Refresh

Update