ScrollingZoomCompletedEventArgs.CorrelationId Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém a ID de correlação associada à alteração do fator zoom, retornada anteriormente por ZoomToou ZoomBy,AddZoomVelocity.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingZoomCompletedEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Valor da propriedade

Int32

int

A ID de correlação associada à alteração do fator zoom.

Comentários

Cada alteração programática de rolagem ou zoom 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 gatilho.

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 ZoomTo gerarão duas IDs de 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.