DynamicDocumentPaginator Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje abstraktní základní třídu, která podporuje automatické stránkování na pozadí a sledování pozic obsahu napříč repaginations kromě metod a vlastností vlastní základní třídy.
public ref class DynamicDocumentPaginator abstract : System::Windows::Documents::DocumentPaginatorpublic abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginatortype DynamicDocumentPaginator = class
inherit DocumentPaginatorPublic MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator- Dědičnost
Poznámky
Ve výchozím nastavení DynamicDocumentPaginator bude automaticky stránkovat obsah na pozadí (tento proces začíná, když IsBackgroundPaginationEnabled je true, což je výchozí nastavení).
Pokud IsBackgroundPaginationEnabled je true, rozložení bude také repagován kvůli změnám v obsahu nebo změnách v PageSize.
K PaginationProgress události dochází po dokončení stránkování (nebo opětovného vytvoření) jedné nebo více stránek, například v následujících situacích:
PaginationProgress k událostem dochází, protože obsah je stránkován na pozadí. V závislosti na implementaci může dojít k události při stránkování jedné nebo více stránek (PaginationProgressEventArgs určuje, které stránky byly stránkovány).
Volání nebo GetPageGetPageAsync může způsobit PaginationProgress , že dojde k události, pokud zadaná stránka nebyla stránkována. Pokud je například stránkování na pozadí povolené (IsBackgroundPaginationEnabled =
true), ale stránkování bylo dokončeno až na třetí stránku, volání GetPage s argumentem 6 způsobí stránkování stránek čtyři, pět, šest a sedm. Po dokončení PaginationProgress bude vyvolána událost s PaginationProgressEventArgs nastavením Start = 4 a Count = 4.Při povoleném stránkování na pozadí (IsBackgroundPaginationEnabled =
true) může změna PageSize obsahu ve formátu toku, jako FlowDocumentje například , způsobit opakování a přidružené PaginationProgress události. Všimněte si, že PageSize nemá žádný vliv na opětovné vytváření obsahu s pevným formátem, například FixedDocument, kde velikost stránky vizuálu nemá vliv na rozložení.
K PaginationCompleted události dochází také v případě, že je stránkování na pozadí zakázané. Pokud například existuje jenom jedna stránka obsahu a IsBackgroundPaginationEnabled = falsevolání GetPage s argumentem 0 způsobí dvě události:
Událost PaginationProgress s PaginationProgressEventArgs nastavením Start = 0 a Count = 1.
Událost PaginationCompleted .
Konstruktory
| Name | Description |
|---|---|
| DynamicDocumentPaginator() |
Inicializuje novou instanci DynamicDocumentPaginator třídy. |
Vlastnosti
| Name | Description |
|---|---|
| IsBackgroundPaginationEnabled |
Získá nebo nastaví hodnotu určující, zda se stránkování provádí automaticky na pozadí v reakci na určité události, například změna velikosti stránky. |
| IsPageCountValid |
Při přepsání v odvozené třídě získá hodnotu určující, zda PageCount je celkový počet stránek. (Zděděno od DocumentPaginator) |
| PageCount |
Při přepsání v odvozené třídě získá počet stránek aktuálně formátovaných. (Zděděno od DocumentPaginator) |
| PageSize |
Při přepsání v odvozené třídě získá nebo nastaví navrženou šířku a výšku každé stránky. (Zděděno od DocumentPaginator) |
| Source |
Při přepsání v odvozené třídě vrátí prvek, který je stránkován. (Zděděno od DocumentPaginator) |
Metody
| Name | Description |
|---|---|
| CancelAsync(Object) |
Zruší předchozí GetPageAsync operaci nebo GetPageNumberAsync operaci. (Zděděno od DocumentPaginator) |
| ComputePageCount() |
Vynutí stránkování obsahu, aktualizuje PageCount se novým součtem a nastaví IsPageCountValid na |
| ComputePageCountAsync() |
Asynchronně vynutí stránkování obsahu, aktualizuje PageCount se s novým součtem a nastaví IsPageCountValid na |
| ComputePageCountAsync(Object) |
Asynchronně vynutí stránkování obsahu, aktualizuje PageCount se s novým součtem, nastaví IsPageCountValid na |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetObjectPosition(Object) |
Při přepsání v odvozené třídě vrátí ContentPosition pro zadané Object. |
| GetPage(Int32) |
Při přepsání v odvozené třídě získá DocumentPage pro zadané číslo stránky. (Zděděno od DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage zadané číslo stránky a přiřadí zadané ID asynchronnímu úkolu. (Zděděno od DocumentPaginator) |
| GetPageAsync(Int32) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage zadané číslo stránky. (Zděděno od DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Při přepsání v odvozené třídě vrátí číslo stránky založené na nule zadané ContentPosition. |
| GetPageNumberAsync(ContentPosition, Object) |
Asynchronně vrátí (prostřednictvím Této metody vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPosition. |
| GetPageNumberAsync(ContentPosition) |
Asynchronně vrátí (prostřednictvím Této metody vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPosition. |
| GetPagePosition(DocumentPage) |
Při přepsání v odvozené třídě získá pozici zadané stránky v obsahu dokumentu. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnComputePageCountCompleted(AsyncCompletedEventArgs) |
ComputePageCountCompleted Vyvolá událost. (Zděděno od DocumentPaginator) |
| OnGetPageCompleted(GetPageCompletedEventArgs) |
GetPageCompleted Vyvolá událost. (Zděděno od DocumentPaginator) |
| OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs) |
GetPageNumberCompleted Vyvolá událost. |
| OnPagesChanged(PagesChangedEventArgs) |
PagesChanged Vyvolá událost. (Zděděno od DocumentPaginator) |
| OnPaginationCompleted(EventArgs) |
PaginationCompleted Vyvolá událost. |
| OnPaginationProgress(PaginationProgressEventArgs) |
PaginationProgress Vyvolá událost. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Událost
| Name | Description |
|---|---|
| ComputePageCountCompleted |
Nastane po ComputePageCountAsync dokončení operace. (Zděděno od DocumentPaginator) |
| GetPageCompleted |
Nastane po GetPageAsync dokončení. (Zděděno od DocumentPaginator) |
| GetPageNumberCompleted |
Nastane po GetPageNumberAsync dokončení. |
| PagesChanged |
Nastane při změně obsahu dokumentu. (Zděděno od DocumentPaginator) |
| PaginationCompleted |
Nastane, když je stránkovaný veškerý obsah dokumentu. |
| PaginationProgress |
Nastane, když byla stránkována jedna nebo více stránek obsahu. |
