FocusManager.TryMoveFocus 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
按 tab 键顺序) 遍历 (的方向。
返回
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
用于帮助标识下一个元素以使用键盘/控制器/远程导航接收焦点的选项。
返回
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
。