Control.GotFocus イベント

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

Control.GotFocus イベント

コントロールがフォーカスを受け取ると発生します。

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

Visual Basic (宣言)

Public Event GotFocus As
 EventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As EventHandler

AddHandler instance.GotFocus, handler

C#

public event EventHandler GotFocus

C++

public:
event EventHandler^ GotFocus {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
public void add_GotFocus (EventHandler value)

/** @event */
public void remove_GotFocus (EventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

キーボード (Tab、Shift + Tab など) を使用するか、Select メソッドまたは SelectNextControl メソッドを呼び出すか、ContainerControl.ActiveControl プロパティを現在のフォームに設定してフォーカスを変更するとき、次の順序でフォーカス イベントが発生します。

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

マウスを使用するか Focus メソッドを呼び出してフォーカスを変更するとき、フォーカス イベントは次の順序で発生します。

1. Enter

2. GotFocus

3. LostFocus

4. Leave

5. Validating

6. Validated

CausesValidation プロパティが false に設定されている場合、Validating イベントおよび Validated イベントは発生しません。

メモ :    GotFocus イベントおよび LostFocus イベントは、Windows メッセージ WM_KILLFOCUS および WM_SETFOCUS に結び付けられた、低水準のフォーカス イベントです。一般的に、GotFocus イベントおよび LostFocus イベントは、UICues を更新するとき、またはカスタム コントロールを作成するときにだけ使用されます。代わりに、Activated イベントおよび Deactivate イベントを使用する Form クラスを除くすべてのコントロールに、Enter イベントおよび Leave イベントを使用する必要があります。GotFocus イベントおよび LostFocus イベントの詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library) にあるプラットフォーム SDK ドキュメントの「Keyboard Input Reference」で WM_SETFOCUS および WM_KILLFOCUS のトピックを参照してください。

注意
LostFocus イベント ハンドラの中からフォーカスを設定しないでください。フォーカスを設定すると、アプリケーションやオペレーティング システムが応答を停止することがあります。LostFocus イベントの詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja) にあるプラットフォーム SDK ドキュメントの「Keyboard Input Reference」で WM_KILLFOCUS、および「Messages and Message Queues」で Message Deadlocks を参照してください。

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

プラットフォーム

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、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
OnGotFocus
LostFocus
Control.Enter イベント
Form.Activated
Form.Activate