更新 : 2007 年 11 月
名前空間 :
System.Windows.Forms アセンブリ :
System.Windows.Forms (System.Windows.Forms.dll 内)
<BrowsableAttribute(False)> _
Public Event GotFocus As EventHandler
Dim instance As Control
Dim handler As EventHandler
AddHandler instance.GotFocus, handler
[BrowsableAttribute(false)]
public event EventHandler GotFocus
[BrowsableAttribute(false)]
public:
event EventHandler^ GotFocus {
void add (EventHandler^ value);
void remove (EventHandler^ value);
}
/** @event */
/** @attribute BrowsableAttribute(false) */
public void add_GotFocus (EventHandler value)
/** @event */
/** @attribute BrowsableAttribute(false) */
public void remove_GotFocus (EventHandler value)
キーボード (Tab、Shift + Tab など) を使用するか、Select メソッドまたは SelectNextControl メソッドを呼び出すか、ContainerControl..::.ActiveControl プロパティを現在のフォームに設定してフォーカスを変更するとき、次の順序でフォーカス イベントが発生します。
Enter
GotFocus
Leave
Validating
Validated
LostFocus
マウスを使用するか Focus メソッドを呼び出してフォーカスを変更するとき、フォーカス イベントは次の順序で発生します。
Enter
GotFocus
LostFocus
Leave
Validating
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/ja.) にあるプラットフォーム SDK ドキュメントの「Keyboard Input Reference」で WM_SETFOCUS および WM_KILLFOCUS のトピックを参照してください。
.gif "Caution メモ") 注意 : |
|---|
LostFocus イベント ハンドラの中からフォーカスを設定しないでください。フォーカスを設定すると、アプリケーションやオペレーティング システムが応答を停止することがあります。LostFocus イベントの詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja.) にあるプラットフォーム SDK ドキュメントの「Keyboard Input Reference」で WM_KILLFOCUS、および「Messages and Message Queues」で Message Deadlocks を参照してください。 |
イベント処理の詳細については、「イベントの利用」を参照してください。
このメンバの使用方法を次のコード例に示します。この例では、イベント ハンドラが GotFocus イベントの発生について報告します。この報告によって、イベントがいつ発生したかを認識できるため、デバッグの際に役立ちます。
このプログラム例を実行するには、Button や ComboBox など、Control から継承する型のインスタンスを含むプロジェクトにコードを貼り付けます。その後、Control1 インスタンスに名前を付け、イベント ハンドラが GotFocus イベントに関連付けられるようにします。
Private Sub Control1_GotFocus(sender as Object, e as EventArgs) _
Handles Control1.GotFocus
Console.WriteLine("You are in the Control.GotFocus event.")
End Sub
private void Control1_GotFocus(Object sender, EventArgs e) {
MessageBox.Show("You are in the Control.GotFocus event.");
}
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
.NET Framework
サポート対象 : 3.5、3.0、2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 3.5、2.0、1.0
参照