focusmanager_findnextfocusableelement_1604618823.md

-api-id	-api-type
M:Microsoft.UI.Xaml.Input.FocusManager.FindNextFocusableElement(Microsoft.UI.Xaml.Input.FocusNavigationDirection,Windows.Foundation.Rect)	winrt method

Microsoft.UI.Xaml.Input.FocusManager.FindNextFocusableElement

-description

Retrieves the element that should receive focus based on the specified navigation direction and hint rectangle.

-parameters

-param focusNavigationDirection

The direction that focus moves from element to element within the app UI.

-param hintRect

A bounding rectangle used to influence which element is most likely to be considered the next to receive focus. Examples where this can be useful include:

• When no element currently has focus, specifying a small rectangle at a screen location of (-1, -1) starts focus from the upper left corner of the display.
• In a program guide where you want to ensure programs at the current time receive focus. (The focus algorithm might favor shows at a later time based on a number of factors.)

-returns

null if focus cannot be set in the specified direction.

-remarks

You can also use either the FindNextElement(FocusNavigationDirection, FindNextElementOptions) method or the FindNextElement(FocusNavigationDirection) method to programmatically move focus. These methods retrieve the element (as a DependencyObject) that will receive focus based on the specified navigation direction (directional navigation only, cannot be used to emulate tab navigation).

Note

We recommend using the FindNextElement method instead of FindNextFocusableElement because FindNextFocusableElement retrieves a UIElement, which returns null if the next focusable element is not a UIElement (such as a Hyperlink object).

-examples

-see-also

FindNextFocusableElement(FocusNavigationDirection), Keyboard interactions, Focus navigation for keyboard, gamepad, remote control, and accessibility tools, Programmatic focus navigation