FocusManager.TryMoveFocus メソッド

定義

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

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
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 として) を取得します (方向ナビゲーションのみ、タブナビゲーションのエミュレートには使用できません)。

Note

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

こちらもご覧ください

適用対象

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