VisualInteractionSource.IsPositionXRailsEnabled Propriedade

Definição

Namespace:

Microsoft.UI.Composition.Interactions

Indica se o movimento panorâmico no eixo x está limitado.

A propriedade IsPositionXRailsEnabled define a configuração de grade para quando o movimento panorâmico do eixo X é enviado para o InteractionTracker correspondente. Quando habilitada, se a parte inicial da panela for angulada em um intervalo específico em relação ao eixo X, o componente Y da panela será ignorado e considerado uma panela horizontal perfeita. Essa propriedade geralmente é habilitada em situações em que uma experiência de rolagem X e Y está habilitada, mas também requer um movimento panorâmico horizontal confiável e perfeito.

public:
 property bool IsPositionXRailsEnabled { bool get(); void set(bool value); };

bool IsPositionXRailsEnabled();

void IsPositionXRailsEnabled(bool value);

public bool IsPositionXRailsEnabled { get; set; }

var boolean = visualInteractionSource.isPositionXRailsEnabled;
visualInteractionSource.isPositionXRailsEnabled = boolean;

Public Property IsPositionXRailsEnabled As Boolean

Valor da propriedade

Boolean

bool

Valor booliano que indica se o movimento panorâmico no eixo x está limitado.

Exemplos

void SetupInteractionSource(ContainerVisual container, InteractionTracker 	tracker)
{
  // Setup the InteractionSource
  _interactionSource = VisualInteractionSource.Create(container);
  // Enable the property for rails on the X axis being enabled
  _interactionSource.IsPositionXRailsEnabled = true;
  // Add the InteractionSource to the InteractionTracker
  tracker.InteractionSources.Add(_interactionSource);
}

Comentários

Quando essa propriedade está habilitada, o sistema fornece mais leniência no que é considerado uma panela horizontal "perfeita". Muitas vezes, quando um dedo atravessa a tela, é muito difícil para um usuário final obter uma panela perfeita na direção X. Essa propriedade ajuda a possibilitar o movimento panorâmico horizontal "perfeito" em cenários (como rolagem multidirecional) em que o movimento panorâmico X e Y já está habilitado.

Quando habilitados, os painéis dentro de 22,5 graus do eixo horizontal serão reconhecidos como painéis horizontais "perfeitos" – em outras palavras, seus componentes Y serão ignorados. Observe que o ângulo da panela é determinado dentro dos primeiros milímetros da interação e manterá esse ângulo até que o dedo seja levantado. Se estiver fora do limite de 22,5 graus do eixo, o componente Y será reconhecido.

O diagrama abaixo mostra isso em um formato visual:

Observação

Quando os trilhos estão habilitados, isso tem um impacto no encadeamento. O sistema só será encadeado até seu acenstor mais próximo VisualInteractionSource quando a panela estiver dentro de 22,5 graus do eixo.