Share via

FocusManager.FindNextFocusableElement 方法

  • 参考

定义

命名空间:
Windows.UI.Xaml.Input

重载

FindNextFocusableElement(FocusNavigationDirection)

检索应根据指定的导航方向接收焦点的元素。
FindNextFocusableElement(FocusNavigationDirection, Rect)

根据指定的导航方向和提示矩形检索应接收焦点的元素。

FindNextFocusableElement(FocusNavigationDirection)

编辑

检索应根据指定的导航方向接收焦点的元素。

public:
 static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
 static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
function findNextFocusableElement(focusNavigationDirection)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection) As UIElement

参数

focusNavigationDirection
FocusNavigationDirection

焦点在应用程序 UI 中从元素移动到元素的方向。

返回

UIElement

如果不能在指定方向设置焦点，则为 null。

属性
OverloadAttribute

注解

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

注意

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

另请参阅

适用于

FindNextFocusableElement(FocusNavigationDirection, Rect)

编辑

根据指定的导航方向和提示矩形检索应接收焦点的元素。

public:
 static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
 static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection, Rect const& hintRect);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
function findNextFocusableElement(focusNavigationDirection, hintRect)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection, hintRect As Rect) As UIElement

参数

focusNavigationDirection
FocusNavigationDirection

焦点在应用 UI 中从元素移动到元素的方向。

hintRect
Rect

一个边界矩形，用于影响最有可能被视为下一个接收焦点的元素。 这非常有用的示例包括：

  • 当当前没有元素具有焦点时，指定屏幕位置 (-1、-1 的小矩形) 从屏幕左上角开始聚焦。
  • 在节目指南中，你希望确保节目在当前时间获得焦点。 (焦点算法可能会根据多种因素在以后倾向于显示。)

返回

UIElement

如果不能在指定方向设置焦点，则为 null。

属性
OverloadAttribute

注解

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

注意

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

另请参阅

适用于