Control.Handle プロパティ

.NET Framework クラス ライブラリ リファレンス

Control.Handle プロパティ

コントロールのバインド先のウィンドウ ハンドルを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Handle As IntPtr

Visual Basic (使用法)

Dim instance As Control
Dim value As IntPtr

value = instance.Handle

C#

public IntPtr Handle { get; }

C++

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

J#

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

JScript

public final function get
 Handle () : IntPtr

プロパティ値
コントロールのウィンドウ ハンドル (HWND) を格納する IntPtr。

解説

Handle プロパティの値は Windows HWND です。ハンドルがまだ作成されていない場合は、このプロパティを参照すると強制的にハンドルが作成されます。

使用例

ControlPaint.DrawFocusRectangle および Handle プロパティを使用したコード例を次に示します。この例を実行するには、次のコードをフォームに貼り付けます。そして、Button1 および Button2 という名前の 2 つのボタンをフォームに追加し、すべてのイベントを必ずそれぞれのイベント ハンドラに関連付けます。

Visual Basic

' 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

C#

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

C++

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

J#

// 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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
CreateControl
CreateHandle
Control.CreateParams プロパティ
DestroyHandle
IsHandleCreated
OnHandleCreated
RecreateHandle
RecreatingHandle
UpdateStyles