ScrollingScrollCompletedEventArgs.CorrelationId Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan ID korelasi yang terkait dengan perubahan offset, yang sebelumnya dikembalikan oleh ScrollTo, , ScrollByatau AddScrollVelocity.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollCompletedEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Nilai Properti

Int32

int

ID korelasi yang terkait dengan perubahan offset.

Keterangan

Setiap gulir terprogram atau perubahan zoom dikaitkan dengan nomor ID korelasi tertentu. Angka tersebut disediakan saat meminta perubahan tampilan dengan ScrollTo, , ScrollBy, AddScrollVelocityZoomTo, ZoomBy atau AddZoomVelocity sebagai nilai yang dikembalikan. ID korelasi juga disediakan dalam peristiwa BringingIntoView yang diangkat di awal partisipasi permintaan bawa-ke-tampilan. Ini menandai awal masa pakai ID korelasi.

Angka yang sama kemudian diekspos dalam peristiwa berikutnya seperti ScrollAnimationStarting dan ScrollCompleted, atau ZoomAnimationStarting dan ZoomCompleted. Ini memungkinkan Anda mencocokkan peristiwa dengan panggilan atau permintaan metode pemicunya.

Masa pakai ID korelasi selalu berakhir dalam peristiwa penyelesaian: ScrollCompleted atau ZoomCompleted.

Masa pakai ID korelasi dapat tumpang tindih. Misalnya, dua panggilan back-to-back ScrollTo akan menghasilkan dua ID korelasi dengan masa pakai yang tumpang tindih.

Saat perubahan tampilan baru diminta saat tampilan lama masih berlangsung, tampilan lama dibatalkan. Pembatalan tersebut memicu ScrollCompleted atau ZoomCompleted peristiwa dengan yang lama CorrelationId.