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 die automatische Hintergrund paginierung und die Nachverfolgung von Inhaltspositionen über Repaginationen hinweg unterstützt, zusätzlich zu den Methoden und Eigenschaften der eigenen Basisklasse.
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 vor paginaten (dieser Prozess beginnt, wenn IsBackgroundPaginationEnabled dies der Fall ist , was die Standardeinstellung ist true).
Wenn IsBackgroundPaginationEnabled dies der Zeitpunkt ist true, wird das Layout aufgrund von Änderungen an Inhalten oder Änderungen in PageSize.
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 von einer oder mehreren Seiten auftreten (PaginationProgressEventArgs gibt an, welche Seiten aus paginiert wurden).
Aufrufe an GetPage oder GetPageAsync können dazu führen, dass ein PaginationProgress Ereignis auftritt, wenn die angegebene Seite nicht paginiert wurde. Wenn z. B. die Paginierung im Hintergrund aktiviert ist (IsBackgroundPaginationEnabled =
true), die Paginierung jedoch nur bis zur dritten Seite abgeschlossen wurde, führt ein Aufruf mit GetPage einem Argument von 6 dazu, dass die Seiten vier, fünf, sechs und sieben seiten angeordnet werden. Nach Abschluss wird ein PaginationProgress Ereignis mit PaginationProgressEventArgs den Einstellungen Start = 4 und Count = 4 ausgelöst.Wenn die Hintergrund paginierung aktiviert ist (IsBackgroundPaginationEnabled =
true), kann eine Änderung des PageSize Flussformatinhalts, z. B. eines FlowDocument, zu Einer Repagination und zugehörigen PaginationProgress Ereignissen führen. Beachten Sie, dass PageSize die Umgestaltung bei Inhalten im festen Format nicht wirksam ist, z FixedDocument. B. wenn sich die visuelle Seitengröße nicht auf das Layout auswirkt.
Ein PaginationCompleted Ereignis tritt auch auf, wenn die Hintergrund paginierung deaktiviert ist. Wenn beispielsweise nur eine Seite mit Inhalt vorhanden ist und IsBackgroundPaginationEnabled = false), das Aufrufen GetPage mit einem Argument von 0 führt zu zwei Ereignissen:
Ein PaginationProgress Ereignis mit PaginationProgressEventArgs den Einstellungen Start = 0 und Count = 1.
Ein PaginationCompleted Ereignis.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DynamicDocumentPaginator() |
Initialisiert eine neue Instanz der DynamicDocumentPaginator-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsBackgroundPaginationEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Paginierung als Reaktion auf bestimmte Ereignisse, z. B. eine Änderung der Seitengröße, automatisch im Hintergrund ausgeführt wird. |
| IsPageCountValid |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob PageCount es sich um die Gesamtanzahl der Seiten handelt. (Geerbt von DocumentPaginator) |
| PageCount |
Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der aktuell formatierten Seiten ermittelt. (Geerbt von DocumentPaginator) |
| PageSize |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird die vorgeschlagene Breite und Höhe jeder Seite abgerufen oder festgelegt. (Geerbt von DocumentPaginator) |
| Source |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das element zurückgegeben, das paginiert wird. (Geerbt von DocumentPaginator) |
Methoden
| Name | Beschreibung |
|---|---|
| CancelAsync(Object) |
Bricht einen vorherigen GetPageAsync vorgang oder GetPageNumberAsync einen Vorgang ab. (Geerbt von DocumentPaginator) |
| ComputePageCount() |
Erzwingt eine Paginierung des Inhalts, aktualisiert PageCount sich mit der neuen Summe und legt sie IsPageCountValid auf |
| ComputePageCountAsync() |
Erzwingt asynchron eine Paginierung des Inhalts, aktualisiert PageCount mit der neuen Summe und legt diese IsPageCountValid fest auf |
| ComputePageCountAsync(Object) |
Erzwingt asynchron eine Paginierung des Inhalts, wird PageCount mit der neuen Summe aktualisiert und auf IsPageCountValid. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetObjectPosition(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein ContentPosition Wert für die angegebene Klasse zurückgegeben Object. |
| GetPage(Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft sie die DocumentPage für die angegebene Seitenzahl ab. (Geerbt von DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Gibt asynchron (durch das GetPageCompleted Ereignis) die DocumentPage für die angegebene Seitenzahl zurück und weist der asynchronen Aufgabe die angegebene ID zu. (Geerbt von DocumentPaginator) |
| GetPageAsync(Int32) |
Gibt asynchron (durch das GetPageCompleted Ereignis) die DocumentPage für die angegebene Seitenzahl zurück. (Geerbt von DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Wenn eine abgeleitete Klasse überschrieben wird, wird die nullbasierte Seitenzahl des angegebenen Werts zurückgegeben ContentPosition. |
| GetPageNumberAsync(ContentPosition, Object) |
Gibt (über die This-Methode das GetPageNumberCompleted Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück. |
| GetPageNumberAsync(ContentPosition) |
Gibt (über die This-Methode das GetPageNumberCompleted Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück. |
| GetPagePosition(DocumentPage) |
Wenn eine abgeleitete Klasse überschrieben wird, wird die Position der angegebenen Seite im Inhalt des Dokuments abgerufen. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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
| Name | Beschreibung |
|---|---|
| ComputePageCountCompleted |
Tritt auf, wenn ein ComputePageCountAsync Vorgang abgeschlossen ist. (Geerbt von DocumentPaginator) |
| GetPageCompleted |
Tritt auf, wenn GetPageAsync der Vorgang abgeschlossen ist. (Geerbt von DocumentPaginator) |
| GetPageNumberCompleted |
Tritt auf, wenn GetPageNumberAsync der Vorgang abgeschlossen ist. |
| PagesChanged |
Tritt auf, wenn der Dokumentinhalt geändert wird. (Geerbt von DocumentPaginator) |
| PaginationCompleted |
Tritt auf, wenn alle Dokumentinhalte aus paginiert wurden. |
| PaginationProgress |
Tritt auf, wenn eine oder mehrere Inhaltsseiten paginiert wurden. |
