DynamicDocumentPaginator Klasse
Definition
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::DocumentPaginatorpublic abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginatortype DynamicDocumentPaginator = class
inherit DocumentPaginatorPublic MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator- Vererbung
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 |
| ComputePageCountAsync() |
Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf |
| ComputePageCountAsync(Object) |
Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf |
| 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. |
