FocusManager.FindNextFocusableElement 方法

定义

重载

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 中的元素的方向。

返回

如果无法按指定方向设置焦点,null

属性

注解

还可以使用 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)处指定一个小矩形将启动显示左上角的焦点。
  • 在希望确保当前时间的程序接收焦点的程序指南中。 (焦点算法可能更倾向于根据多种因素在以后显示。

返回

如果无法按指定方向设置焦点,null

属性

注解

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

注意

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

另请参阅

适用于