This documentation is archived and is not being maintained.

Control.CreateHandle Method

Creates a handle for the control.

[Visual Basic]
Protected Overridable Sub CreateHandle()
[C#]
protected virtual void CreateHandle();
[C++]
protected: virtual void CreateHandle();
[JScript]
protected function CreateHandle();

Exceptions

Exception Type Condition
ObjectDisposedException The object is in a disposed state.

Remarks

You typically should not call the CreateHandle method directly. The preferred method is to call the CreateControl method, which forces a handle to be created for the control and its child controls when the control is created.

Notes to Inheritors:  When overriding CreateHandle in a derived class, be sure to call the base class's CreateHandle method to ensure that the handle is created.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

Control Class | Control Members | System.Windows.Forms Namespace | CreateControl | DestroyHandle | RecreateHandle | Handle

Show: