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