ScrollingScrollCompletedEventArgs.CorrelationId Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém a ID de correlação associada à alteração de deslocamentos, retornada anteriormente por ScrollTo, ScrollByou AddScrollVelocity.

public:
 property int CorrelationId { int get(); };

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollCompletedEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Valor da propriedade

Int32

int

A ID de correlação associada aos deslocamentos é alterada.

Comentários

Cada alteração de rolagem ou zoom programática está associada a um número de ID de correlação específico. Esse número é fornecido ao solicitar uma alteração de exibição com ScrollTo, ScrollBy, AddScrollVelocity, ZoomToZoomBy ou AddZoomVelocity como um valor retornado. Uma ID de correlação também é fornecida no evento BringingIntoView gerado no início de uma participação de solicitação bring-into-view. Isso marca o início do tempo de vida de uma ID de correlação.

Esse mesmo número é exposto em eventos subsequentes, como ScrollAnimationStarting e ScrollCompleted, ou ZoomAnimationStarting e ZoomCompleted. Isso permite que você corresponda eventos com a chamada ou a solicitação do método de disparo.

O tempo de vida de uma ID de correlação sempre termina em um evento de conclusão: ScrollCompleted ou ZoomCompleted.

Os tempos de vida das IDs de correlação podem se sobrepor. Por exemplo, duas chamadas consecutivas gerarão duas IDs de ScrollTo correlação com tempos de vida sobrepostos.

Quando uma nova alteração de exibição é solicitada enquanto uma antiga ainda está em andamento, a antiga é cancelada. Esse cancelamento dispara um ScrollCompleted evento ou ZoomCompleted com o antigo CorrelationId.