次の方法で共有


FocusManager.TryMoveFocus メソッド

定義

オーバーロード

TryMoveFocus(FocusNavigationDirection)

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

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

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

TryMoveFocus(FocusNavigationDirection)

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

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
public static bool TryMoveFocus(FocusNavigationDirection 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

属性

注釈

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

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

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

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

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

注意

FindNextFocusableElement は UIElement を取得するため、FindNextFocusableElement の代わりに FindNextElement メソッドを使用することをお勧めします。これは、次のフォーカス可能な要素が UIElement ( Hyperlink オブジェクトなど) でない場合は 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

属性

Windows の要件

デバイス ファミリ
Windows 10 Creators Update (10.0.15063.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v4.0 で導入)

注釈

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

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

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

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

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

注意

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

こちらもご覧ください

適用対象