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
)。