Control.Handle-Eigenschaft

Artikel
08/20/2007

Ruft das Fensterhandle ab, an das das Steuerelement gebunden ist.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public ReadOnly Property Handle As IntPtr
'Usage
Dim instance As Control
Dim value As IntPtr

value = instance.Handle

public IntPtr Handle { get; }

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

/** @property */
public final IntPtr get_Handle ()

public final function get Handle () : IntPtr

Eigenschaftenwert

Ein IntPtr mit dem Fensterhandle (HWND) des Steuerelements.

Hinweise

Der Wert der Handle-Eigenschaft ist ein Windows-HWND. Wenn das Handle noch nicht erstellt wurde, wird das Erstellen durch den Verweis auf diese Eigenschaft erzwungen.

Beispiel

Im folgenden Codebeispiel wird die Verwendung von ControlPaint.DrawFocusRectangle und der Handle-Eigenschaft veranschaulicht. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein. Fügen Sie dem Formular zwei Schaltflächen mit dem Namen Button1 und Button2 hinzu, und stellen Sie sicher, dass alle Ereignisse den entsprechenden Ereignishandlern zugeordnet sind.

' 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

// 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.
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(Object sender, System.EventArgs e)
{
    ControlPaint.DrawFocusRectangle(Graphics.FromHwnd(button2.get_Handle()), 
        button2.get_ClientRectangle());
} //button1_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
CreateControl
CreateHandle
Control.CreateParams-Eigenschaft
DestroyHandle
IsHandleCreated
OnHandleCreated
RecreateHandle
RecreatingHandle
UpdateStyles

Freigeben über