VisualInteractionSource.IsPositionYRailsEnabled Propriedade

Definição

Namespace:

Microsoft.UI.Composition.Interactions

Indica se o movimento panorâmico no eixo y está gradeado.

A propriedade IsPositionYRailsEnabled define a configuração de grade para quando o movimento panorâmico do eixo Y é enviado para o InteractionTracker correspondente. Quando habilitado, se a parte inicial da panela for angulada em um intervalo específico em relação ao eixo Y, o componente X da panela será ignorado e considerado uma panela vertical 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 vertical confiável e perfeito.

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

bool IsPositionYRailsEnabled();

void IsPositionYRailsEnabled(bool value);

public bool IsPositionYRailsEnabled { get; set; }

var boolean = visualInteractionSource.isPositionYRailsEnabled;
visualInteractionSource.isPositionYRailsEnabled = boolean;

Public Property IsPositionYRailsEnabled As Boolean

Valor da propriedade

Boolean

bool

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

Exemplos

void SetupInteractionSource(ContainerVisual container, InteractionTracker 	tracker)
{
  // Setup the InteractionSource
  _interactionSource = VisualInteractionSource.Create(container);
  // Enable the property for rails on the Y axis being enabled
  _interactionSource.IsPositionYRailsEnabled = 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 vertical "perfeita". Muitas vezes, quando um dedo atravessa a tela, é muito difícil para um usuário final obter uma panela perfeita na direção Y. Essa propriedade ajuda a possibilitar o movimento panorâmico vertical "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 vertical serão reconhecidos como painéis verticais "perfeitos". Em outras palavras, seus componentes X 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 X 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.