DynamicDocumentPaginator Třída

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

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::DocumentPaginator

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

type DynamicDocumentPaginator = class
    inherit DocumentPaginator

Public MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator

Dědičnost

Object

DocumentPaginator

DynamicDocumentPaginator

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:

1. Událost PaginationProgress s PaginationProgressEventArgs nastavením Start = 0 a Count = 1.

2. 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 true. (Zděděno od DocumentPaginator)
ComputePageCountAsync()	Asynchronně vynutí stránkování obsahu, aktualizuje PageCount nový součet a nastaví IsPageCountValid na true. (Zděděno od DocumentPaginator)
ComputePageCountAsync(Object)	Asynchronně vynutí stránkování obsahu, aktualizace PageCount s novým součtem nastaví IsPageCountValid na true. (Zděděno od DocumentPaginator)
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.