Control.Handle Property

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Gets the window handle that the control is bound to.

public:
 property IntPtr Handle { IntPtr get(); };

[System.ComponentModel.Browsable(false)]
public IntPtr Handle { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Property Value

IntPtr

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

Implements

Handle

Attributes: BrowsableAttribute

Examples

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 );
}

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

' This method draws a focus rectangle on Button2 using the 
' handle and client rectangle of Button2.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click
    ControlPaint.DrawFocusRectangle(Graphics.FromHwnd(Button2.Handle), _
    Button2.ClientRectangle)
End Sub

Remarks

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.

Applies to