次の方法で共有

FocusManager.TryMoveFocus メソッド

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml.Input

オーバーロード

TryMoveFocus(FocusNavigationDirection)

フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

指定したナビゲーション オプションを使用して、フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。

TryMoveFocus(FocusNavigationDirection)

編集

フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
function tryMoveFocus(focusNavigationDirection)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

パラメーター

focusNavigationDirection
FocusNavigationDirection

移動する方向 (タブ オーダー)。

戻り値

Boolean

bool

true フォーカスが移動した場合。それ以外の場合は false。

属性
OverloadAttribute

注釈

タブ オーダーは、ユーザーが Tab キー (前方) または Shift + Tab (後方) を押して、あるコントロールから別のコントロールに移動する順序です。

このメソッドは、タブ オーダー シーケンスと動作を使用して、UI 内のすべてのフォーカス可能な要素を走査します。

  • フォーカスがタブ オーダーの最初の要素にあり、 FocusNavigationDirection.Previous が指定されている場合、フォーカスは最後の要素に移動します。
  • フォーカスがタブ オーダーの最後の要素にあり、 FocusNavigationDirection.Next が指定されている場合、フォーカスは最初の要素に移動します。

FindNextElement(FocusNavigationDirection, FindNextElementOptions) メソッドまたは FindNextElement(FocusNavigationDirection) メソッドを使用して、プログラムによってフォーカスを移動することもできます。 これらのメソッドは、指定したナビゲーション方向に基づいてフォーカスを受け取る要素 ( DependencyObject として) を取得します (方向ナビゲーションのみ、タブ ナビゲーションのエミュレートには使用できません)。

注意

の代わりに FindNextFocusableElementFindNextElement メソッドを使用することをお勧めします。これはFindNextFocusableElementUIElement、次のフォーカス可能な要素が ( Hyperlink オブジェクトなど) でないUIElement場合に を返nullします。

こちらもご覧ください

適用対象

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

編集

指定したナビゲーション オプションを使用して、フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);
[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);
function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Boolean

パラメーター

focusNavigationDirection
FocusNavigationDirection

移動する方向 (タブ オーダー)。

focusNavigationOptions
FindNextElementOptions

キーボード/コントローラー/リモート ナビゲーションを使用してフォーカスを受け取る次の要素を識別するのに役立つオプション。

戻り値

Boolean

bool

true フォーカスが移動した場合。それ以外の場合は false。

属性
OverloadAttribute

注釈

タブ オーダーは、ユーザーが Tab キー (前方) または Shift + Tab (後方) を押して、あるコントロールから別のコントロールに移動する順序です。

このメソッドは、タブ オーダー シーケンスと動作を使用して、UI 内のすべてのフォーカス可能な要素を走査します。

  • フォーカスがタブ オーダーの最初の要素にあり、 FocusNavigationDirection.Previous が指定されている場合、フォーカスは最後の要素に移動します。
  • フォーカスがタブ オーダーの最後の要素にあり、 FocusNavigationDirection.Next が指定されている場合、フォーカスは最初の要素に移動します。

FindNextElement(FocusNavigationDirection, FindNextElementOptions) メソッドまたは FindNextElement(FocusNavigationDirection) メソッドを使用して、プログラムによってフォーカスを移動することもできます。 これらのメソッドは、指定したナビゲーション方向に基づいてフォーカスを受け取る要素 ( DependencyObject として) を取得します (方向ナビゲーションのみ、タブ ナビゲーションのエミュレートには使用できません)。

注意

の代わりに FindNextFocusableElementFindNextElement メソッドを使用することをお勧めします。これはFindNextFocusableElementUIElement、次のフォーカス可能な要素が ( Hyperlink オブジェクトなど) でないUIElement場合に を返nullします。

こちらもご覧ください

適用対象