FocusManager.FindNextFocusableElement Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
FindNextFocusableElement(FocusNavigationDirection) |
Recupera o elemento que deve receber o foco com base na direção de navegação especificada. |
FindNextFocusableElement(FocusNavigationDirection, Rect) |
Recupera o elemento que deve receber o foco com base na direção de navegação especificada e no retângulo de dica. |
Recupera o elemento que deve receber o foco com base na direção de navegação especificada.
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
Parâmetros
- focusNavigationDirection
- FocusNavigationDirection
A direção em que o foco se move de elemento para elemento dentro da interface do usuário do aplicativo.
Retornos
nulo se o foco não puder ser definido na direção especificada.
- Atributos
Comentários
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
- FindNextFocusableElement(FocusNavigationDirection, Rect)
- Interações por teclado
- Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
- Navegação por foco programática
Aplica-se a
Recupera o elemento que deve receber o foco com base na direção de navegação especificada e no retângulo de dica.
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
Parâmetros
- focusNavigationDirection
- FocusNavigationDirection
A direção em que o foco se move de elemento para elemento dentro da interface do usuário do aplicativo.
- hintRect
- Rect
Um retângulo delimitador usado para influenciar qual elemento provavelmente será considerado o próximo a receber o foco. Exemplos em que isso pode ser útil incluem:
- Quando nenhum elemento atualmente tem foco, especificar um pequeno retângulo em um local de tela de (-1, -1) inicia o foco no canto superior esquerdo da tela.
- Em um guia de programa em que você deseja garantir que os programas no momento recebam o foco. (O algoritmo de foco pode favorecer shows posteriormente com base em vários fatores.)
Retornos
nulo se o foco não puder ser definido na direção especificada.
- Atributos
Comentários
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
- FindNextFocusableElement(FocusNavigationDirection)
- Interações por teclado
- Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
- Navegação por foco programática