Partilhar via


XYFocusNavigationStrategy Enumeração

Definição

Especifica a estratégia de desambiguação usada para navegar entre vários destinos candidatos usando XYFocusDownNavigationStrategy, XYFocusLeftNavigationStrategy, XYFocusRightNavigationStrategy e XYFocusUpNavigationStrategy.

Observação

Outros fatores, como o elemento focalizado anteriormente ou a proximidade com o eixo da direção de navegação, podem influenciar o resultado final da navegação.

public enum class XYFocusNavigationStrategy
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class XYFocusNavigationStrategy
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum XYFocusNavigationStrategy
Public Enum XYFocusNavigationStrategy
Herança
XYFocusNavigationStrategy
Atributos

Campos

Auto 0

Indica que a estratégia de navegação é herdada dos ancestrais do elemento. Se todos os ancestrais tiverem um valor de Auto, a estratégia de fallback será Projection.

NavigationDirectionDistance 2

Indica que o foco se move para o elemento mais próximo do eixo da direção de navegação.

A borda do rect delimitado correspondente à direção de navegação é estendida e projetada para identificar destinos candidatos. O primeiro elemento encontrado é identificado como o destino. No caso de vários candidatos, o elemento mais próximo é identificado como o destino. Se ainda houver vários candidatos, o elemento na extremidade superior esquerda é identificado como o candidato.

Navegação de foco – distância

O foco se move de A para C e, em seguida, de C para B na navegação para baixo

Projection 1

Indica que o foco se move para o primeiro elemento encontrado ao projetar a borda do elemento focalizado no momento na direção da navegação.

Navegação de foco – projeção

O foco se move de A para D na navegação para baixo com base na projeção da borda inferior de A

RectilinearDistance 3

Indica que o foco se move para o elemento mais próximo com base na distância 2D mais curta (métrica de Manhattan).

Essa distância é calculada ao adicionar a distância principal e a secundária de cada candidato potencial. No caso de um empate:

  • O primeiro elemento à esquerda será selecionado se a direção de navegação estiver para cima ou para baixo
  • O primeiro elemento na parte superior será selecionado se a direção de navegação for esquerda ou direita

Aqui, mostramos como o foco se move de A para B com base na distância retilinear.

  • Distância (A, B, Para baixo) = 10 + 0 = 10
  • Distância (A, C, Para baixo) = 30 + 0 = 30
  • Distância (A, D, Para baixo) 30 + 0 = 30
Navegação de foco – distância retilinear

O foco passa de A para B com base na distância retilinear

Comentários

A navegação XY é usada para navegar em uma interface do usuário com um controlador de jogo ou setas direcionais do teclado. Para obter mais informações, consulte Gamepad e interações de controle remoto

Aplica-se a

Confira também