FocusManager.TryMoveFocus Método

Definição

Namespace:

Microsoft.UI.Xaml.Input

Sobrecargas

TryMoveFocus(FocusNavigationDirection)	Tenta alterar o foco do elemento com foco para o próximo elemento focalizável na direção especificada.
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)	Tenta alterar o foco do elemento com foco para o próximo elemento focalizável na direção especificada, usando as opções de navegação especificadas.

TryMoveFocus(FocusNavigationDirection)

Tenta alterar o foco do elemento com foco para o próximo elemento focalizável na direção especificada.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);

/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& 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

A direção a percorrer (na ordem de tabulação).

Retornos

Boolean

bool

true se o foco foi movido; caso contrário, false.

Atributos

OverloadAttribute

Comentários

A ordem de tabulação é a ordem na qual um usuário passa de um controle para outro pressionando a tecla Tab (para frente) ou Shift+Tab (para trás).

Esse método usa a sequência de ordem de tabulação e o comportamento para percorrer todos os elementos focalizáveis na interface do usuário.

• Se o foco estiver no primeiro elemento na ordem de tabulação e FocusNavigationDirection.Previous for especificado, o foco passará para o último elemento.
• Se o foco estiver no último elemento na ordem de tabulação e FocusNavigationDirection.Next for especificado, o foco será movido para o primeiro elemento.

Você também pode usar o método FindNextElement(FocusNavigationDirection, FindNextElementOptions) ou o método FindNextElement(FocusNavigationDirection) para mover o foco programaticamente. Esses métodos recuperam o elemento (como dependencyObject) que receberá o foco com base na direção de navegação especificada (somente navegação direcional, não pode ser usado para emular a navegação de tabulação).

Observação

É recomendável usar o método FindNextElement em vez de FindNextFocusableElement porque FindNextFocusableElement recupera um UIElement, que retorna null se o próximo elemento focalizável não for um UIElement (como um objeto Hyperlink ).

Confira também

• TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
• Interações por teclado
• Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
• Navegação por foco programática

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Tenta alterar o foco do elemento com foco para o próximo elemento focalizável na direção especificada, usando as opções de navegação 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

A direção a percorrer (na ordem de tabulação).

focusNavigationOptions

FindNextElementOptions

As opções para ajudar a identificar o próximo elemento a receber o foco com navegação remota/teclado/controlador.

Retornos

Boolean

bool

true se o foco foi movido; caso contrário, false.

Atributos

OverloadAttribute

Comentários

A ordem de tabulação é a ordem na qual um usuário passa de um controle para outro pressionando a tecla Tab (para frente) ou Shift+Tab (para trás).

Esse método usa a sequência de ordem de tabulação e o comportamento para percorrer todos os elementos focalizáveis na interface do usuário.

• Se o foco estiver no primeiro elemento na ordem de tabulação e FocusNavigationDirection.Previous for especificado, o foco passará para o último elemento.
• Se o foco estiver no último elemento na ordem de tabulação e FocusNavigationDirection.Next for especificado, o foco será movido para o primeiro elemento.

Você também pode usar o método FindNextElement(FocusNavigationDirection, FindNextElementOptions) ou o método FindNextElement(FocusNavigationDirection) para mover o foco programaticamente. Esses métodos recuperam o elemento (como dependencyObject) que receberá o foco com base na direção de navegação especificada (somente navegação direcional, não pode ser usado para emular a navegação de tabulação).

Observação

É recomendável usar o método FindNextElement em vez de FindNextFocusableElement porque FindNextFocusableElement recupera um UIElement, que retorna null se o próximo elemento focalizável não for um UIElement (como um objeto Hyperlink ).

Confira também

• TryMoveFocus(FocusNavigationDirection)
• Interações por teclado
• Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
• Navegação por foco programática