DynamicDocumentPaginator.GetPageNumberAsync Yöntem

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationCore.dll

Belirtilen ContentPositionöğesinin sıfır tabanlı sayfa numarasını döndürür.

Aşırı Yüklemeler

GetPageNumberAsync(ContentPosition)	Zaman uyumsuz olarak, belirtilen ContentPositionöğesinin sıfır tabanlı sayfa numarasını döndürür (Bu yöntem aracılığıyla olayı oluştururGetPageNumberCompleted).
GetPageNumberAsync(ContentPosition, Object)	Zaman uyumsuz olarak, belirtilen ContentPositionöğesinin sıfır tabanlı sayfa numarasını döndürür (Bu yöntem aracılığıyla olayı oluştururGetPageNumberCompleted).

GetPageNumberAsync(ContentPosition)

Zaman uyumsuz olarak, belirtilen ContentPositionöğesinin sıfır tabanlı sayfa numarasını döndürür (Bu yöntem aracılığıyla olayı oluştururGetPageNumberCompleted).

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parametreler

contentPosition

ContentPosition

Sayfa numarası gereken içerik konumu.

Açıklamalar

Bu yöntemin zaman uyumsuz işlemini iptal etmenin tek yolu tüm zaman uyumsuz işlemleri iptal etmektir. Bunu, bu yöntemin diğer aşırı yüklemesiyle karşıtlık oluşturun: GetPageNumberAsync(ContentPosition, Object).

Bu yöntem olayı tetikler GetPageNumberCompleted . Sayfa numarası olaya olay bağımsız değişkenlerinden biri olarak geçirilir. Sayfa numarasını almak için bu yöntemin nasıl kullanılacağına bakın GetPageNumberAsync(ContentPosition, Object) .

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetPageNumber(ContentPosition)özel durumlara bakın.

GetPageNumberAsync(ContentPosition, Object)

Zaman uyumsuz olarak, belirtilen ContentPositionöğesinin sıfır tabanlı sayfa numarasını döndürür (Bu yöntem aracılığıyla olayı oluştururGetPageNumberCompleted).

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parametreler

contentPosition

ContentPosition

sayfa numarasını döndürecek içerik konumu öğesi.

userState

Object

Zaman uyumsuz görev için benzersiz tanımlayıcı.

Açıklamalar

yönteminin bu aşırı yüklemesi, tüm zaman uyumsuz işlemleri iptal etmeden bu zaman uyumsuz işlemi iptal etme işlemini mümkün kılar.

Bu yöntem olayı tetikler GetPageNumberCompleted .

Aşağıdaki adımlarda, belirli bir zaman uyumsuz olarak verilen contentPosition sayfa numarasının nasıl alındığı gösterilmektedir.

1. Bir GetPageNumberCompletedEventHandler temsilci oluşturun ve olaylarla ilgili bildirim GetPageNumberCompleted almak için ekleyin.

2. zaman uyumsuz görevi tanımlamak için kullanılacak istenen ve benzersiz userState bir nesneyi belirten contentPosition çağrısıGetPageNumberAsync(ContentPosition, Object).

3. Olay gerçekleştiğinde ve temsilci çağrıldığında, olayın GetPageNumberCompletedEventArgs.UserState özelliğini özgün GetPageNumberAsyncuserState parametresiyle karşılaştırın.

4. GetPageNumberCompletedEventArgs.UserState özelliği özgün GetPageNumberAsync(ContentPosition, Object)userStateile eşleştiğinde işlem tamamlanır ve sayfa numarası hazırdır. GetPageNumberCompletedEventArgs(.ContentPosition özelliği özgün parametreyle GetPageNumberAsync(ContentPosition, Object)contentPosition de eşleşecektir.)

5. GetPageNumberCompletedEventArgs.PageNumber özelliği, belirtilen contentPositionöğesinin sıfır tabanlı sayfa numarasını içerir.

GetPageNumber , ile benzer işlevler GetPageNumberAsyncsağlar ancak zaman uyumlu işlem için kullanılabilir.