DynamicDocumentPaginator Klasse

Referenz

Definition

Namespace:: System.Windows.Documents

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine abstrakte Basisklasse bereit, die zusätzlich zu den Methoden und Eigenschaften der eigenen Basisklasse die automatische Hintergrundpaginierung und die Nachverfolgung von Inhaltspositionen über Neupaginierungen hinweg unterstützt.

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

Vererbung: Object

DocumentPaginator
DynamicDocumentPaginator

Hinweise

Standardmäßig wird ein DynamicDocumentPaginator Inhalt im Hintergrund automatisch vorpapaginieren (dieser Prozess beginnt, wenn IsBackgroundPaginationEnabled ist , was die Standardeinstellung ist true).

Wenn IsBackgroundPaginationEnabled ist true, wird das Layout auch aufgrund von Änderungen am Inhalt oder Änderungen in PageSizeneu erstellt.

Das PaginationProgress Ereignis tritt nach Abschluss der Paginierung (oder Repagination) einer oder mehrerer Seiten auf, z. B. in den folgenden Situationen:

PaginationProgress Ereignisse treten auf, wenn Inhalte im Hintergrund paginiert werden. Je nach Implementierung kann das Ereignis beim Paginieren einer oder mehrerer Seiten auftreten (PaginationProgressEventArgs gibt an, welche Seiten paginiert wurden).
Aufrufe von GetPage oder GetPageAsync können dazu führen, dass ein PaginationProgress Ereignis auftritt, wenn die angegebene Seite nicht paginiert wurde. Wenn beispielsweise die Hintergrundpapageinierung aktiviert ist (IsBackgroundPaginationEnabled = true), die Paginierung jedoch nur bis zur dritten Seite abgeschlossen wurde, führt ein Aufruf von von GetPage mit einem Argument von 6 dazu, dass seiten vier, fünf, sechs und sieben paginiert werden. Nach Abschluss wird ein PaginationProgress Ereignis mit PaginationProgressEventArgs den Einstellungen Start = 4 und Count = 4 ausgelöst.
Wenn die Hintergrundpa paginierung aktiviert ist (IsBackgroundPaginationEnabled = true), kann eine Änderung in PageSize Flussformatinhalten, z. B. ein FlowDocument, zu Einer Wiederholung und zugeordneten PaginationProgress Ereignissen führen. Beachten Sie, dass PageSize keine Auswirkungen auf die Repagination von Inhalten mit festen Formaten hat, z. B FixedDocument. , wobei die visuelle Seitengröße sich nicht auf das Layout auswirkt.

Ein PaginationCompleted Ereignis tritt auch auf, wenn die Hintergrund paginierung deaktiviert ist. Wenn beispielsweise nur eine Inhaltsseite vorhanden ist und IsBackgroundPaginationEnabled = false) mit dem Argument 0 aufgerufen GetPage wird, ergeben sich zwei Ereignisse:

Ein PaginationProgress Ereignis mit PaginationProgressEventArgs den Einstellungen Start = 0 und Count = 1.
Ein PaginationCompleted Ereignis.

Konstruktoren

DynamicDocumentPaginator()

Initialisiert eine neue Instanz der DynamicDocumentPaginator-Klasse.

Eigenschaften

IsBackgroundPaginationEnabled	Ruft einen Wert ab, der angibt, ob die Paginierung automatisch im Hintergrund als Reaktion auf bestimmte Ereignisse, z. B. eine Änderung der Seitengröße, durchgeführt wird, oder legt diesen fest.
IsPageCountValid	Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob PageCount die Gesamtzahl der Seiten angibt. (Geerbt von DocumentPaginator)
PageCount	Ruft beim Überschreiben in einer abgeleiteten Klasse die Anzahl der derzeit formatierten Seiten ab. (Geerbt von DocumentPaginator)
PageSize	Ruft beim Überschreiben in einer abgeleiteten Klasse die vorgeschlagene Breite und Höhe jeder Seite ab oder legt diese fest. (Geerbt von DocumentPaginator)
Source	Gibt beim Überschreiben in einer abgeleiteten Klasse das derzeit paginierte Element zurück. (Geerbt von DocumentPaginator)

Methoden

CancelAsync(Object)	Bricht einen früheren GetPageAsync-Vorgang oder GetPageNumberAsync-Vorgang ab. (Geerbt von DocumentPaginator)
ComputePageCount()	Erzwingt eine Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf `true` fest. (Geerbt von DocumentPaginator)
ComputePageCountAsync()	Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf `true` fest. (Geerbt von DocumentPaginator)
ComputePageCountAsync(Object)	Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf `true` fest. (Geerbt von DocumentPaginator)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectPosition(Object)	Gibt beim Überschreiben in einer abgeleiteten Klasse eine ContentPosition für das angegebene Object zurück.
GetPage(Int32)	Ruft beim Überschreiben in einer abgeleiteten Klasse DocumentPage für die angegebene Seitenzahl ab. (Geerbt von DocumentPaginator)
GetPageAsync(Int32)	Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück. (Geerbt von DocumentPaginator)
GetPageAsync(Int32, Object)	Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück und weist der asynchronen Aufgabe die angegebene ID zu. (Geerbt von DocumentPaginator)
GetPageNumber(ContentPosition)	Gibt beim Überschreiben in einer abgeleiteten Klasse die nullbasierte Seitenzahl der angegebenen ContentPosition zurück.
GetPageNumberAsync(ContentPosition)	Gibt (über das GetPageNumberCompleted-Ereignis) die nullbasierte Seitenzahl der angegebenen ContentPosition asynchron zurück.
GetPageNumberAsync(ContentPosition, Object)	Gibt (über das GetPageNumberCompleted-Ereignis) die nullbasierte Seitenzahl der angegebenen ContentPosition asynchron zurück.
GetPagePosition(DocumentPage)	Ruft beim Überschreiben in einer abgeleiteten Klasse die Position der angegebenen Seite im Inhalt des Dokuments ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Löst das ComputePageCountCompleted-Ereignis aus. (Geerbt von DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Löst das GetPageCompleted-Ereignis aus. (Geerbt von DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	Löst das GetPageNumberCompleted-Ereignis aus.
OnPagesChanged(PagesChangedEventArgs)	Löst das PagesChanged-Ereignis aus. (Geerbt von DocumentPaginator)
OnPaginationCompleted(EventArgs)	Löst das PaginationCompleted-Ereignis aus.
OnPaginationProgress(PaginationProgressEventArgs)	Löst das PaginationProgress-Ereignis aus.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

ComputePageCountCompleted	Tritt ein, wenn ein ComputePageCountAsync-Vorgang beendet wurde. (Geerbt von DocumentPaginator)
GetPageCompleted	Tritt auf, wenn GetPageAsync abgeschlossen wurde. (Geerbt von DocumentPaginator)
GetPageNumberCompleted	Tritt auf, wenn GetPageNumberAsync abgeschlossen wurde.
PagesChanged	Tritt auf, wenn der Dokumentinhalt geändert wird. (Geerbt von DocumentPaginator)
PaginationCompleted	Tritt ein, wenn der gesamte Dokumentinhalt paginiert wurde.
PaginationProgress	Tritt ein, wenn eine oder mehrere Inhaltsseiten paginiert wurden.

Gilt für: