UIElement.FocusState プロパティ

定義

名前空間:

Microsoft.UI.Xaml

このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。

public:
 property FocusState FocusState { FocusState get(); };

FocusState FocusState();

public FocusState FocusState { get; }

var focusState = uIElement.focusState;

Public ReadOnly Property FocusState As FocusState

プロパティ値

FocusState

列挙体の値。 値 Unfocused は、コントロールにフォーカスがないことを示します。

注釈

このプロパティは、コントロールがキーボードまたはその他の方法でフォーカスされているかどうかに応じて、異なるビジュアル スタイルを使用するコントロールをサポートしています。 一部のコントロールでは、コントロールがキーボード アクションによってフォーカスされている場合は表示フォーカス インジケーターを表示する視覚的な状態を使用しますが、ポインター アクションによってフォーカスされたコントロールの場合はインジケーターは表示されません。 このようなコントロールの内部ロジックは OnGotFocus を実装し、送信者から FocusState の値を取得します。 FocusState が Keyboard の場合、 GoToState を呼び出すことによって、フォーカス四角形を含む別の名前付きビジュアル状態が読み込まれます。 通常、フォーカス関連のビジュアル状態は、既定のコントロール テンプレート XAML でグループ化されます。 フォーカスの手段に応じて異なるフォーカス ビジュアルを使用するカスタム コントロールは、この同じロジック自体を実装できます。 OnGotFocus を参照してください。

このプロパティを使用するもう 1 つの方法は、 FocusManager を使用して UI 全体のどの要素がフォーカスを持っているかを判断し、その要素でこのメソッドを呼び出して、コントロールがフォーカスを受け取った方法に関する情報を取得することです。