Partilhar via


FocusManager.TryMoveFocus Método

Definição

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

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

Retornos

Boolean

bool

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

Atributos

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 passará 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 nulo se o próximo elemento focalizável não for um UIElement (como um objeto Hyperlink ).

Confira também

Aplica-se a

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 foco com teclado/controlador/navegação remota.

Retornos

Boolean

bool

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

Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

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 passará 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 nulo se o próximo elemento focalizável não for um UIElement (como um objeto Hyperlink ).

Confira também

Aplica-se a