Control.HandleCreated イベント

.NET Framework 4

その他のバージョン

コントロールに対してハンドルが作成されると発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

構文

C++

コピー

[BrowsableAttribute(false)]
public event EventHandler HandleCreated

解説

Control が初めて表示されるときにハンドルが作成されます。たとえば、Visible が false に設定された状態で Control が作成される場合、Visible が true に設定されるまで HandleCreated イベントは発生しません。

イベント処理の詳細については、「イベントの利用」を参照してください。

例

このメンバーの使用方法を次のコード例に示します。この例では、HandleCreated イベントの発生時にイベントハンドラーからレポートされます。この報告によって、イベントがいつ発生したかを認識できるため、デバッグの際に役立ちます。複数のイベントまたは頻繁に発生するイベントについて報告するには、MessageBox.Show を Console.WriteLine に置き換えるか、複数行 TextBox にメッセージを追加することを検討してください。

このプログラム例を実行するには、Button や ComboBox など、Control から継承する型のインスタンスを含むプロジェクトにコードを貼り付けます。その後、Control1 インスタンスに名前を付け、イベントハンドラーが HandleCreated イベントに関連付けられていることを確認します。

コピー


private void Control1_HandleCreated(Object sender, EventArgs e) {

   MessageBox.Show("You are in the Control.HandleCreated event.");

}

バージョン情報

.NET Framework

サポート対象: 4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

サポート対象: 4、3.5 SP1

プラットフォーム

Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

参照

Control クラス

System.Windows.Forms 名前空間

CreateControl

CreateHandle

CreateParams

DestroyHandle

Handle

IsHandleCreated

OnHandleCreated

RecreateHandle