UIElement.GotFocus イベント

  • リファレンス

定義

名前空間:
Windows.UI.Xaml
編集

UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。

// Register
event_token GotFocus(RoutedEventHandler const& handler) const;

// Revoke with event_token
void GotFocus(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::GotFocus_revoker GotFocus(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler GotFocus;
function onGotFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gotfocus", onGotFocus);
uIElement.removeEventListener("gotfocus", onGotFocus);
- or -
uIElement.ongotfocus = onGotFocus;
Public Custom Event GotFocus As RoutedEventHandler 
<uiElement GotFocus="eventhandler"/>

イベントの種類

RoutedEventHandler

注釈

可能な限り、FocusManager イベントではなく UIElement フォーカス ルーティング イベントを使用することをお勧めします。

一度に 1 つの UI 要素にのみフォーカスを設定できます。

コントロールは、別のコントロールがフォーカスを失ったり、アプリケーション ビューが変更されたり、ユーザーがアプリケーションを切り替えたり、ユーザーがシステムと対話してアプリケーションがフォアグラウンドでなくなったりしたときにフォーカスを取得できます。

LostFocus は GotFocus の前に発生します。

Panel や GridView などのコンテナーでコントロール合成または UI 合成と処理を使用している場合は、イベント データに OriginalSource をチェックして、コンポジション内のどの要素が実際にフォーカスを受け取ったかを判断できます。

GotFocus には特殊なイベント データがありません。 GotFocus を処理する場合は、要素がフォーカスを取得する原因となったユーザー コードかアプリ コードかを判断できます。 ハンドラーでこれを確認するには、イベントの送信者を Control オブジェクトにキャストし、FocusState をチェックします。

キーボード フォーカスはキーボード イベント処理に特に関連します。KeyUp および KeyDown キー イベントのソースにできるのは、現在キーボードに焦点を当てた UIElement だけなのでです。 アプリケーションは、アプリ全体のキー イベントを使用してアクセスキーまたはアクセラレータ キーを検出できるように、初期化アクションとして Focus を呼び出す場合があります。 詳しくは、「キーボード操作」をご覧ください。

GotFocus はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

特定のWindows ランタイム コントロールには、GotFocus イベントのクラスベースの処理が含まれる場合があります。 その場合、コントロールには OnGotFocus メソッドのオーバーライドが含まれている可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ、GotFocus イベントは、そのコントロールのユーザー コード ハンドラーによって処理するために発生しません。 コントロールは、フォーカスの四角形を表示するビジュアル状態プロパティを読み込むためにイベントを処理する場合があります。

コントロールのフォーカス四角形は、現在フォーカスされている要素を識別し、ユーザーがアプリケーション UI のタブ シーケンス内のどこにいるかを示すことによって、アクセシビリティを支援する重要なビジュアル コンポーネントです。 場合によっては、フォーカス アクションの FocusState が、表示されているフォーカス インジケーターを表示するかどうかに関連します。

イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。 タブ シーケンスとアクセシビリティの詳細については、「 キーボード アクセシビリティ」を参照してください。

適用対象

こちらもご覧ください