Control::Handle Property

 

Gets the window handle that the control is bound to.

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

public:
[BrowsableAttribute(false)]
property IntPtr Handle {
	virtual IntPtr get() sealed;
}

Property Value

Type: System::IntPtr

An IntPtr that contains the window handle (HWND) of the control.

The value of the Handle property is a Windows HWND. If the handle has not yet been created, referencing this property will force the handle to be created.

The following code example demonstrates using the ControlPaint::DrawFocusRectangle and the Handle property. To run the example paste the following code in a form. Add two buttons named Button1 and Button2 to the form and ensure all events are connected to their event handlers.

// This method draws a focus rectangle on Button2 using the 
// handle and client rectangle of Button2.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   ControlPaint::DrawFocusRectangle( Graphics::FromHwnd( Button2->Handle ), Button2->ClientRectangle );
}

.NET Framework
Available since 1.1
Return to top
Show: