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

按 tab 键顺序) 遍历 (的方向。

返回

Boolean

bool

如果焦点移动,则为 true;否则为 false

属性

注解

Tab 键顺序是用户通过按 Tab 键 (向前) 或 Shift+Tab (向后) 从一个控件移动到另一个控件的顺序。

此方法使用 Tab 键顺序和行为遍历 UI 中的所有可聚焦元素。

如果焦点位于 Tab 键顺序中的第一个元素上,并且指定 了 FocusNavigationDirection.Previous ,则焦点将移动到最后一个元素。

如果焦点位于 Tab 键顺序中的最后一个元素上,并且指定 了 FocusNavigationDirection.Next ,则焦点将移动到第一个元素。

还可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法以编程方式移动焦点。 这些方法检索元素 (为 DependencyObject) ,该元素将仅根据指定导航方向接收焦点 (方向,不能用于模拟选项卡导航) 。

注意

建议使用 FindNextElement 方法而不是 FindNextFocusableElement 方法,因为 FindNextFocusableElement 会检索 UIElement,如果下一个可聚焦元素不是 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

按 tab 键顺序) 遍历 (的方向。

focusNavigationOptions
FindNextElementOptions

用于帮助识别下一个元素以使用键盘/控制器/远程导航接收焦点的选项。

返回

Boolean

bool

如果焦点移动,则为 true;否则为 false

属性

Windows 要求

设备系列
Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

Tab 键顺序是用户通过按 Tab 键 (向前) 或 Shift+Tab (向后) 从一个控件移动到另一个控件的顺序。

此方法使用 Tab 键顺序和行为遍历 UI 中的所有可聚焦元素。

如果焦点位于 Tab 键顺序中的第一个元素上,并且指定 了 FocusNavigationDirection.Previous ,则焦点将移动到最后一个元素。

如果焦点位于 Tab 键顺序中的最后一个元素上,并且指定 了 FocusNavigationDirection.Next ,则焦点将移动到第一个元素。

还可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法以编程方式移动焦点。 这些方法检索元素 (为 DependencyObject) ,该元素将仅根据指定导航方向接收焦点 (方向,不能用于模拟选项卡导航) 。

注意

建议使用 FindNextElement 方法而不是 FindNextFocusableElement 方法,因为 FindNextFocusableElement 会检索 UIElement,如果下一个可聚焦元素不是 UIElement ((如 Hyperlink 对象) ),则返回 null。

另请参阅

适用于