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í umístění obsahu napříč převtělováními, kromě metod a vlastností své 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 automaticky předběžně stránkuje obsah na pozadí (tento proces začíná, když IsBackgroundPaginationEnabled je true, což je výchozí nastavení).
Pokud IsBackgroundPaginationEnabled je truehodnota , rozložení se také změní kvůli změnám obsahu nebo změnám v PageSizesouboru .
Událost PaginationProgress nastane po dokončení stránkování (nebo převyšování) jedné nebo více stránek, například v následujících situacích:
PaginationProgress k událostem dochází při stránkování obsahu na pozadí. V závislosti na implementaci může k události dojít při stránkování jedné nebo více stránek (PaginationProgressEventArgs určuje, které stránky byly stránkovány).
Volání metody GetPage nebo GetPageAsync může způsobit, PaginationProgress že dojde k události, pokud zadaná stránka nebyla stránkována. Pokud je například povolená stránkování na pozadí (IsBackgroundPaginationEnabled =
true), ale stránkování bylo dokončeno až do třetí stránky, volání GetPage metody s argumentem 6 způsobí stránkování stránek čtyři, pět, šest a sedm. Po dokončení PaginationProgress se vyvolá událost s PaginationProgressEventArgs nastavením Start = 4 a Count = 4.Pokud je povolená stránkování na pozadí (IsBackgroundPaginationEnabled =
true), může změna PageSize obsahu ve formátu toku, jako FlowDocumentje , způsobit převyšování a přidružené PaginationProgress události. Mějte na paměti, že PageSize nemá žádný vliv na převyšování obsahu s pevným formátem, jako FixedDocumentje například , kde velikost stránky vizuálu nemá vliv na rozložení.
Událost PaginationCompleted nastane také v případě, že je zakázána stránkování na pozadí. Pokud je například k dispozici pouze jedna stránka obsahu a IsBackgroundPaginationEnabled = false), volá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
| DynamicDocumentPaginator() |
Inicializuje novou instanci DynamicDocumentPaginator třídy . |
Vlastnosti
| IsBackgroundPaginationEnabled |
Získá nebo nastaví hodnotu označující, zda stránkování je provedeno automaticky na pozadí v reakci na určité události, jako je například změna velikosti stránky. |
| IsPageCountValid |
Při přepsání v odvozené třídě získá hodnotu označ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 aktuálně formátovaných stránek. (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í element stránkovaný. (Zděděno od DocumentPaginator) |
Metody
| CancelAsync(Object) |
Zruší předchozí GetPageAsync operaci nebo GetPageNumberAsync . (Zděděno od DocumentPaginator) |
| ComputePageCount() |
Vynutí stránkování obsahu, aktualizuje PageCount nový součet a nastaví IsPageCountValid na |
| ComputePageCountAsync() |
Asynchronně vynutí stránkování obsahu, aktualizuje PageCount nový součet a nastaví IsPageCountValid na |
| ComputePageCountAsync(Object) |
Asynchronně vynutí stránkování obsahu, aktualizace PageCount s novým součtem nastaví IsPageCountValid na |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetObjectPosition(Object) |
Při přepsání v odvozené třídě vrátí pro zadanou ContentPositionObjecthodnotu . |
| 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) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky. (Zděděno od DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky a přiřadí zadané ID asynchronní úloze. (Zděděno od DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Při přepsání v odvozené třídě vrátí číslo stránky od nuly zadaného ContentPositionobjektu . |
| GetPageNumberAsync(ContentPosition) |
Asynchronně vrátí (prostřednictvím této metody vyvolá GetPageNumberCompleted událost) číslo stránky od nuly zadaného ContentPosition. |
| GetPageNumberAsync(ContentPosition, Object) |
Asynchronně vrátí (prostřednictvím této metody vyvolá GetPageNumberCompleted událost) číslo stránky od nuly zadaného ContentPosition. |
| GetPagePosition(DocumentPage) |
Při přepsání v odvozené třídě získá pozici zadané stránky v obsahu dokumentu. |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (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
| ComputePageCountCompleted |
Vyvolá se po ComputePageCountAsync dokončení operace. (Zděděno od DocumentPaginator) |
| GetPageCompleted |
Vyvolá se po GetPageAsync dokončení. (Zděděno od DocumentPaginator) |
| GetPageNumberCompleted |
Vyvolá se po GetPageNumberAsync dokončení. |
| PagesChanged |
Vyvolá se při změně obsahu dokumentu. (Zděděno od DocumentPaginator) |
| PaginationCompleted |
Vyvolá se při stránkování veškerého obsahu dokumentu. |
| PaginationProgress |
Nastane, když byla stránkována jedna nebo více stránek obsahu. |
