DynamicDocumentPaginator.GetPageNumberAsync 方法

定義

命名空間:

System.Windows.Documents

組件:

PresentationCore.dll

傳回指定之 ContentPosition之以零起始的頁碼。

多載

GetPageNumberAsync(ContentPosition)	以異步方式傳回 （透過這個方法引發 GetPageNumberCompleted 事件） 指定之 ContentPosition之以零起始的頁碼。
GetPageNumberAsync(ContentPosition, Object)	以異步方式傳回 （透過這個方法引發 GetPageNumberCompleted 事件） 指定之 ContentPosition之以零起始的頁碼。

GetPageNumberAsync(ContentPosition)

以異步方式傳回 （透過這個方法引發 GetPageNumberCompleted 事件） 指定之 ContentPosition之以零起始的頁碼。

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)

參數

contentPosition

ContentPosition

需要其頁碼的內容位置。

備註

取消此方法異步操作的唯一方法是取消所有異步操作。 與此方法的其他多載形成對比：GetPageNumberAsync(ContentPosition, Object)。

這個方法會引發 GetPageNumberCompleted 事件。 頁碼會以其中一個事件自變數的形式傳遞至事件。 如需如何使用此方法取得頁碼，請參閱 GetPageNumberAsync(ContentPosition, Object)。

這個方法會儲存在工作中，它會傳回方法同步對應項可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 GetPageNumber(ContentPosition)擲回的例外狀況。

GetPageNumberAsync(ContentPosition, Object)

以異步方式傳回 （透過這個方法引發 GetPageNumberCompleted 事件） 指定之 ContentPosition之以零起始的頁碼。

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)

參數

contentPosition

ContentPosition

要傳回頁碼的內容位置專案。

userState

Object

異步工作的唯一標識符。

備註

此方法的這個多載可讓您取消此異步操作，而不取消所有異步操作。

這個方法會引發 GetPageNumberCompleted 事件。

下列步驟說明如何以異步方式擷取指定 contentPosition 的頁碼。

1. 建立 GetPageNumberCompletedEventHandler 委派，並將它新增至 GetPageNumberCompleted 事件的通知。

2. 呼叫 GetPageNumberAsync(ContentPosition, Object) 指定所需的 contentPosition，以及將用來識別異步工作的唯一 userState 物件。

3. 當事件發生並呼叫委派時，請比較事件的 GetPageNumberCompletedEventArgs。具有原始 GetPageNumberAsyncuserState 參數的UserState 屬性。

4. 當 GetPageNumberCompletedEventArgs時。UserState 屬性符合原始 GetPageNumberAsync(ContentPosition, Object)userState，作業已完成且頁碼已就緒。 （GetPageNumberCompletedEventArgs.ContentPosition 屬性也會符合原始 GetPageNumberAsync(ContentPosition, Object)contentPosition 參數。

5. GetPageNumberCompletedEventArgs。PageNumber 屬性包含指定之 contentPosition之以零起始的頁碼。

GetPageNumber 提供與 GetPageNumberAsync類似的功能，但用於同步作業。