DynamicDocumentPaginator Klasa

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationCore.dll

Zapewnia abstrakcyjną klasę bazową, która obsługuje automatyczne stronicowanie w tle i śledzenie pozycji zawartości między repaginacjami oprócz metod i właściwości własnej klasy bazowej.

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

Dziedziczenie

Object

DocumentPaginator

DynamicDocumentPaginator

Uwagi

Domyślnie element DynamicDocumentPaginator automatycznie wstępnie stronicuje zawartość w tle (ten proces rozpoczyna się, gdy IsBackgroundPaginationEnabled jest to true, co jest ustawieniem domyślnym).

Gdy IsBackgroundPaginationEnabled ma truewartość , układ będzie również repaginowany z powodu zmian zawartości lub zmian w pliku PageSize.

Zdarzenie PaginationProgress występuje po zakończeniu stronicowania (lub repaginacji) jednej lub kilku stron, takich jak w następujących sytuacjach:

• PaginationProgress zdarzenia występują, ponieważ zawartość jest podzielony na strony w tle. W zależności od implementacji zdarzenie może wystąpić po stronicowaniu jednej lub wielu stron (PaginationProgressEventArgs określa, które strony zostały podzielone na strony).

• Wywołania elementu GetPage lub GetPageAsync mogą spowodować PaginationProgress wystąpienie zdarzenia, jeśli określona strona nie została z podziałem na strony. Jeśli na przykład stronicowanie w tle jest włączone (IsBackgroundPaginationEnabled = true), ale stronicowanie zostało ukończone tylko do trzeciej strony, wywołanie funkcji GetPage z argumentem 6 spowoduje, że strony cztery, pięć, sześć i siedem będą podzielone na strony. Po zakończeniu PaginationProgress zdarzenie zostanie podniesione z ustawieniami PaginationProgressEventArgsStart = 4 i Count = 4.

• Po włączeniu stronicowania w tle (IsBackgroundPaginationEnabled = true) zmiana PageSize zawartości w formacie przepływu, taka jak FlowDocument, może spowodować repaginację i skojarzone PaginationProgress zdarzenia. Należy pamiętać, że PageSize nie ma wpływu na repaginację zawartości w stałym formacie, na przykład FixedDocument, gdzie rozmiar strony wizualizacji nie ma wpływu na układ.

Zdarzenie PaginationCompleted występuje również, gdy stronicowanie w tle jest wyłączone. Jeśli na przykład istnieje tylko jedna strona zawartości i IsBackgroundPaginationEnabled = falsewywołanie GetPage argumentu 0 spowoduje wystąpienie dwóch zdarzeń:

1. Zdarzenie PaginationProgress z ustawieniami PaginationProgressEventArgsStart = 0 i Count = 1.

2. Zdarzenie PaginationCompleted .

Konstruktory

DynamicDocumentPaginator()

Inicjuje nowe wystąpienie klasy DynamicDocumentPaginator.

Właściwości

IsBackgroundPaginationEnabled	Pobiera lub ustawia wartość wskazującą, czy stronicowanie jest wykonywane automatycznie w tle w odpowiedzi na określone zdarzenia, takie jak zmiana rozmiaru strony.
IsPageCountValid	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy PageCount jest to całkowita liczba stron. (Odziedziczone po DocumentPaginator)
PageCount	Po zastąpieniu w klasie pochodnej pobiera liczbę stron aktualnie sformatowanych. (Odziedziczone po DocumentPaginator)
PageSize	Gdy przesłonięć w klasie pochodnej, pobiera lub ustawia sugerowaną szerokość i wysokość każdej strony. (Odziedziczone po DocumentPaginator)
Source	Po przesłonięciu w klasie pochodnej zwraca element, który jest podzielony na strony. (Odziedziczone po DocumentPaginator)

Metody

CancelAsync(Object)	Anuluje poprzednią GetPageAsync operację lub GetPageNumberAsync . (Odziedziczone po DocumentPaginator)
ComputePageCount()	Wymusza stronicowanie zawartości, aktualizuje PageCount nową sumę i ustawia wartość IsPageCountValid .true (Odziedziczone po DocumentPaginator)
ComputePageCountAsync()	Asynchronicznie wymusza stronicowanie zawartości, aktualizuje PageCount nową sumę i ustawia wartość IsPageCountValid na true. (Odziedziczone po DocumentPaginator)
ComputePageCountAsync(Object)	Asynchronicznie wymusza stronicowanie zawartości, aktualizuje PageCount nową sumę i ustawia wartość IsPageCountValid .true (Odziedziczone po DocumentPaginator)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectPosition(Object)	Po przesłonięciu w klasie pochodnej funkcja zwraca wartość ContentPosition dla określonego Objectelementu .
GetPage(Int32)	Po przesłonięciu w klasie pochodnej program pobiera DocumentPage dla określonego numeru strony. (Odziedziczone po DocumentPaginator)
GetPageAsync(Int32)	Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony. (Odziedziczone po DocumentPaginator)
GetPageAsync(Int32, Object)	Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony i przypisuje określony identyfikator do zadania asynchronicznego. (Odziedziczone po DocumentPaginator)
GetPageNumber(ContentPosition)	Po przesłonięciu w klasie pochodnej zwraca numer strony zero określonej ContentPositionwartości .
GetPageNumberAsync(ContentPosition)	Asynchronicznie metoda zwraca (za pomocą tej metody zgłasza GetPageNumberCompleted zdarzenie) numer strony o wartości zerowej określonego ContentPositionelementu .
GetPageNumberAsync(ContentPosition, Object)	Asynchronicznie metoda zwraca (za pomocą tej metody zgłasza GetPageNumberCompleted zdarzenie) numer strony o wartości zerowej określonego ContentPositionelementu .
GetPagePosition(DocumentPage)	Po przesłonięciu w klasie pochodnej pobiera pozycję określonej strony w zawartości dokumentu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	ComputePageCountCompleted Zgłasza zdarzenie. (Odziedziczone po DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	GetPageCompleted Zgłasza zdarzenie. (Odziedziczone po DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	GetPageNumberCompleted Zgłasza zdarzenie.
OnPagesChanged(PagesChangedEventArgs)	PagesChanged Zgłasza zdarzenie. (Odziedziczone po DocumentPaginator)
OnPaginationCompleted(EventArgs)	PaginationCompleted Zgłasza zdarzenie.
OnPaginationProgress(PaginationProgressEventArgs)	PaginationProgress Zgłasza zdarzenie.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

ComputePageCountCompleted	Występuje po zakończeniu ComputePageCountAsync operacji. (Odziedziczone po DocumentPaginator)
GetPageCompleted	Występuje po GetPageAsync zakończeniu. (Odziedziczone po DocumentPaginator)
GetPageNumberCompleted	Występuje po GetPageNumberAsync zakończeniu.
PagesChanged	Występuje, gdy zawartość dokumentu zostanie zmieniona. (Odziedziczone po DocumentPaginator)
PaginationCompleted	Występuje, gdy cała zawartość dokumentu została z podziałem na strony.
PaginationProgress	Występuje, gdy co najmniej jedna strona zawartości została z podziałem na strony.