Share via


FocusManager.TryMoveFocus Método

Definición

Sobrecargas

TryMoveFocus(FocusNavigationDirection)

Intenta cambiar el foco del elemento con el foco al siguiente elemento con foco en la dirección especificada.

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Intenta cambiar el foco del elemento con foco al siguiente elemento con foco en la dirección especificada, utilizando las opciones de navegación especificadas.

TryMoveFocus(FocusNavigationDirection)

Intenta cambiar el foco del elemento con el foco al siguiente elemento con foco en la dirección especificada.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
function tryMoveFocus(focusNavigationDirection)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

Parámetros

focusNavigationDirection
FocusNavigationDirection

Dirección que se va a recorrer (en orden de tabulación).

Devoluciones

Boolean

bool

true si se movió el foco; de lo contrario, false.

Atributos

Comentarios

El orden de tabulación es el orden en el que un usuario se mueve de un control a otro presionando la tecla Tab (adelante) o Mayús+Tab (hacia atrás).

Este método usa la secuencia de orden de tabulación y el comportamiento para recorrer todos los elementos que se pueden centrar en la interfaz de usuario.

Si el foco está en el primer elemento del orden de tabulación y se especifica FocusNavigationDirection.Previous , el foco se mueve al último elemento.

Si el foco está en el último elemento del orden de tabulación y se especifica FocusNavigationDirection.Next , el foco se mueve al primer elemento.

También puede usar el método FindNextElement(FocusNavigationDirection, FindNextElementOptions) o el método FindNextElement(FocusNavigationDirection) para mover el foco mediante programación. Estos métodos recuperan el elemento (como dependencyObject) que recibirá el foco en función de la dirección de navegación especificada (solo la navegación direccional, no se puede usar para emular la navegación por tabulación).

Nota

Se recomienda usar el método FindNextElement en lugar de FindNextFocusableElement porque FindNextFocusableElement recupera un UIElement, que devuelve null si el siguiente elemento con foco no es un UIElement (por ejemplo, un objeto Hyperlink ).

Consulte también

Se aplica a

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Intenta cambiar el foco del elemento con foco al siguiente elemento con foco en la dirección especificada, utilizando las opciones de navegación especificadas.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);
[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);
function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Boolean

Parámetros

focusNavigationDirection
FocusNavigationDirection

Dirección que se va a recorrer (en orden de tabulación).

focusNavigationOptions
FindNextElementOptions

Las opciones para ayudar a identificar el siguiente elemento para recibir el foco con el teclado, el controlador o la navegación remota.

Devoluciones

Boolean

bool

true si se movió el foco; de lo contrario, false.

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Comentarios

El orden de tabulación es el orden en el que un usuario se mueve de un control a otro presionando la tecla Tab (adelante) o Mayús+Tab (hacia atrás).

Este método usa la secuencia de orden de tabulación y el comportamiento para recorrer todos los elementos que se pueden centrar en la interfaz de usuario.

Si el foco está en el primer elemento del orden de tabulación y se especifica FocusNavigationDirection.Previous , el foco se mueve al último elemento.

Si el foco está en el último elemento del orden de tabulación y se especifica FocusNavigationDirection.Next , el foco se mueve al primer elemento.

También puede usar el método FindNextElement(FocusNavigationDirection, FindNextElementOptions) o el método FindNextElement(FocusNavigationDirection) para mover el foco mediante programación. Estos métodos recuperan el elemento (como dependencyObject) que recibirá el foco en función de la dirección de navegación especificada (solo la navegación direccional, no se puede usar para emular la navegación por tabulación).

Nota

Se recomienda usar el método FindNextElement en lugar de FindNextFocusableElement porque FindNextFocusableElement recupera un UIElement, que devuelve null si el siguiente elemento con foco no es un UIElement (por ejemplo, un objeto Hyperlink ).

Consulte también

Se aplica a