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 . UserState 屬性與原始 GetPageNumberAsyncuserState 參數。

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

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

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