FocusManager.FindNextFocusableElement 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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。