Partilhar via


XYFocusNavigationStrategyOverride Enumeração

Definição

Especifica como a estrutura XAML determina o destino de uma navegação XY.

Substitui XYFocusKeyboardNavigationStrategyMode.

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

Campos

Auto 1

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 3

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

A borda do retângulo delimitador correspondente à direção de navegação é estendida e projetada para identificar os destinos de 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

None 0

Nenhuma substituição de navegação é aplicada.

Projection 2

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

Observação

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

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 4

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 estiver à 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 por uma interface do usuário (interface do usuário) com um controlador de jogo ou setas direcionais de teclado. Para obter mais informações, consulte Interações de gamepad e controle remoto

Aplica-se a

Confira também