DynamicDocumentPaginator 類別

定義

命名空間:

System.Windows.Documents

組件:

PresentationCore.dll

提供抽象基底類別，除了其基底類別本身的方法和屬性之外，還支援自動背景分頁，以及在重新分頁間追蹤內容位置。

public ref class DynamicDocumentPaginator abstract : System::Windows::Documents::DocumentPaginator

public abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginator

type DynamicDocumentPaginator = class
    inherit DocumentPaginator

Public MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator

繼承

Object

DocumentPaginator

DynamicDocumentPaginator

備註

根據預設， DynamicDocumentPaginator 會在背景中自動預先分頁內容， (此程式會在 是 true 時 IsBackgroundPaginationEnabled 開始，這是預設設定) 。

當 是 true 時 IsBackgroundPaginationEnabled ，也會因為 內容變更或 中的 PageSize 變更而重新編頁版面配置。

完成 PaginationProgress 分頁 (或重新編頁) 一或多個頁面時發生此事件，例如在下列情況下：

• PaginationProgress 當內容在背景中編頁時，就會發生事件。 根據實作而定，事件可能會在分頁一頁或多個頁面時發生， (PaginationProgressEventArgs 指定哪些頁面已分頁) 。

• GetPage如果指定的頁面尚未編頁，呼叫 或 GetPageAsync 可能會導致 PaginationProgress 發生事件。 例如，如果背景分頁已啟用 (IsBackgroundPaginationEnabled = true) 但分頁最多已完成第三頁，則 的呼叫 GetPage 會讓第四頁、五頁、六頁和七頁編頁。 完成時， PaginationProgress 事件會以 PaginationProgressEventArgs = 4 和 Count = 4 的設定 Start 引發。

• 啟用背景分頁 (IsBackgroundPaginationEnabled = true) 時，流程格式內容的 FlowDocument 變更 PageSize 可能會造成重新編頁和相關聯的 PaginationProgress 事件。 請注意， PageSize 對於固定格式內容的重新編頁沒有任何作用，例如 FixedDocument ，其中視覺頁面大小不會影響版面配置。

PaginationCompleted停用背景分頁時，也會發生事件。 例如，如果只有一頁的內容和 IsBackgroundPaginationEnabled = false) ，則以 0 引數呼叫 GetPage 會導致兩個事件：

1. PaginationProgress設定 PaginationProgressEventArgs 為 Start = 0 和 Count = 1 的事件。

2. 事件 PaginationCompleted 。

建構函式

DynamicDocumentPaginator()

初始化 DynamicDocumentPaginator 類別的新執行個體。

屬性

IsBackgroundPaginationEnabled	取得或設定值，這個值表示是否在回應特定事件 (如頁面大小變更) 時自動在背景執行分頁。
IsPageCountValid	在衍生類別中覆寫時，取得值，指出 PageCount 是否為頁面總數。 (繼承來源 DocumentPaginator)
PageCount	在衍生類別中覆寫時，取得目前已格式化的頁數計數。 (繼承來源 DocumentPaginator)
PageSize	在衍生類別中覆寫時，取得或設定每個頁面的建議寬度和高度。 (繼承來源 DocumentPaginator)
Source	當在衍生類別中覆寫時，傳回正在分頁的項目。 (繼承來源 DocumentPaginator)

方法

CancelAsync(Object)	取消上一項 GetPageAsync 或 GetPageNumberAsync 作業。 (繼承來源 DocumentPaginator)
ComputePageCount()	強制內容分頁、以新的總數更新 PageCount，並將 IsPageCountValid 設定為 true。 (繼承來源 DocumentPaginator)
ComputePageCountAsync()	非同步強制內容分頁、以新的總計更新 PageCount，並將 IsPageCountValid 設定為 true。 (繼承來源 DocumentPaginator)
ComputePageCountAsync(Object)	非同步強制內容分頁、以新的總數更新 PageCount，並將 IsPageCountValid 設定為 true。 (繼承來源 DocumentPaginator)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetObjectPosition(Object)	當在衍生類別中覆寫時，傳回指定之 ContentPosition 的 Object。
GetPage(Int32)	在衍生類別中覆寫時，取得指定之頁碼的 DocumentPage。 (繼承來源 DocumentPaginator)
GetPageAsync(Int32)	非同步傳回 (透過 GetPageCompleted 事件) 指定之頁碼的 DocumentPage。 (繼承來源 DocumentPaginator)
GetPageAsync(Int32, Object)	非同步傳回 (透過 GetPageCompleted 事件) 指定之頁碼的 DocumentPage，並指派指定的 ID 給非同步工作。 (繼承來源 DocumentPaginator)
GetPageNumber(ContentPosition)	在衍生類別中覆寫時，傳回指定之 ContentPosition 的以零起始的頁碼。
GetPageNumberAsync(ContentPosition)	非同步傳回 (透過這個方法會引發 GetPageNumberCompleted 事件) 指定之 ContentPosition 的以零起始的頁碼。
GetPageNumberAsync(ContentPosition, Object)	非同步傳回 (透過這個方法會引發 GetPageNumberCompleted 事件) 指定之 ContentPosition 的以零起始的頁碼。
GetPagePosition(DocumentPage)	在衍生類別中覆寫時，取得文件內容中之指定頁面的位置。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	引發 ComputePageCountCompleted 事件。 (繼承來源 DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	引發 GetPageCompleted 事件。 (繼承來源 DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	引發 GetPageNumberCompleted 事件。
OnPagesChanged(PagesChangedEventArgs)	引發 PagesChanged 事件。 (繼承來源 DocumentPaginator)
OnPaginationCompleted(EventArgs)	引發 PaginationCompleted 事件。
OnPaginationProgress(PaginationProgressEventArgs)	引發 PaginationProgress 事件。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

ComputePageCountCompleted	發生於 ComputePageCountAsync 作業已經完成時。 (繼承來源 DocumentPaginator)
GetPageCompleted	在 GetPageAsync 完成時發生。 (繼承來源 DocumentPaginator)
GetPageNumberCompleted	在 GetPageNumberAsync 完成時發生。
PagesChanged	文件內容變更後發生。 (繼承來源 DocumentPaginator)
PaginationCompleted	所有的文件內容都已分頁時發生。
PaginationProgress	當一個或多個內容頁面已分頁時發生。