DynamicDocumentPaginator Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce una classe base astratta che supporta l'impaginazione in background automatica e posizioni di contenuto di registrazione attraverso nuove impaginazioni in aggiunta ai metodi e alle proprietà delle classe base.
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- Ereditarietà
Commenti
Per impostazione predefinita, un DynamicDocumentPaginator verrà pre-impaginato automaticamente in background (questo processo inizia quando IsBackgroundPaginationEnabled è true, ovvero l'impostazione predefinita).
Quando IsBackgroundPaginationEnabled è true, il layout verrà anche repaginato a causa delle modifiche apportate al contenuto o alle modifiche in PageSize.
L'evento PaginationProgress si verifica al completamento della paginazione (o della replica) di una o più pagine, ad esempio nelle situazioni seguenti:
PaginationProgress gli eventi si verificano quando il contenuto viene impaginato in background. A seconda dell'implementazione, l'evento può verificarsi durante la impaginazione di una o più pagine (PaginationProgressEventArgs specifica quali pagine sono state impaginate).
Le chiamate a GetPage o GetPageAsync possono causare l'esecuzione di un PaginationProgress evento se la pagina specificata non è stata impaginata. Ad esempio, se la paginazione in background è abilitata (IsBackgroundPaginationEnabled =
true) ma la paginazione è stata completata solo fino alla terza pagina, una chiamata di con un argomento di GetPage 6 causerà la impaginazione di quattro, cinque, sei e sette. Al termine, verrà generato un PaginationProgress evento con PaginationProgressEventArgs le impostazioni di Start = 4 e Count = 4.Con la paginazione in background abilitata (IsBackgroundPaginationEnabled =
true), una modifica nel PageSize contenuto in formato flusso, ad esempio , FlowDocumentpuò causare la repaginazione e gli eventi associati.PaginationProgress Si noti che PageSize non ha alcun effetto nella replica del contenuto in formato fisso, ad esempio FixedDocument, in cui le dimensioni della pagina visiva non influiscono sul layout.
Si verifica anche un PaginationCompleted evento quando la paginazione in background è disabilitata. Ad esempio, se è presente una sola pagina di contenuto e IsBackgroundPaginationEnabled = false), la chiamata GetPage con un argomento pari a 0 comporterà due eventi:
Evento PaginationProgress con PaginationProgressEventArgs impostazioni = Start 0 e Count = 1.
Evento PaginationCompleted .
Costruttori
| DynamicDocumentPaginator() |
Inizializza una nuova istanza della classe DynamicDocumentPaginator. |
Proprietà
| IsBackgroundPaginationEnabled |
Ottiene o imposta un valore che indica se l'impaginazione viene eseguita automaticamente in background in risposta a determinati eventi, ad esempio la modifica della dimensione della pagina. |
| IsPageCountValid |
Quando è sottoposto a override in una classe derivata, consente di ottenere un valore che indica se PageCount è il numero totale di pagine. (Ereditato da DocumentPaginator) |
| PageCount |
Quando è sottoposto a override in una classe derivata, ottiene il conteggio del numero di pagine attualmente formattate. (Ereditato da DocumentPaginator) |
| PageSize |
Quando viene sottoposto a override in una classe derivata, ottiene o imposta la larghezza e l'altezza suggerite di ciascuna pagina. (Ereditato da DocumentPaginator) |
| Source |
Quando è sottoposto a override in una classe derivata, restituisce l'elemento impaginato. (Ereditato da DocumentPaginator) |
Metodi
| CancelAsync(Object) |
Annulla un'operazione precedente dell'elemento GetPageAsync o GetPageNumberAsync. (Ereditato da DocumentPaginator) |
| ComputePageCount() |
Forza una paginazione del contenuto, aggiorna PageCount con il nuovo totale e imposta IsPageCountValid su |
| ComputePageCountAsync() |
Forza in modo asincrono un'impaginazione del contenuto, aggiorna PageCount con il nuovo totale e imposta IsPageCountValid su |
| ComputePageCountAsync(Object) |
Forza in modo asincrono un'impaginazione del contenuto, aggiorna PageCount con il nuovo totale e imposta IsPageCountValid su |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetObjectPosition(Object) |
Quando è sottoposto a override in una classe derivata, restituisce un oggetto ContentPosition per l'oggetto Object specificato. |
| GetPage(Int32) |
Quando viene sottoposto a override in una classe derivata, ottiene l'elemento DocumentPage per il numero di pagina specificata. (Ereditato da DocumentPaginator) |
| GetPageAsync(Int32) |
Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato. (Ereditato da DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato e assegna l'ID specificato all'attività asincrona. (Ereditato da DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Quando viene sottoposto a override in una classe derivata, restituisce il numero di pagine in base zero dell'oggetto ContentPosition specificato. |
| GetPageNumberAsync(ContentPosition) |
Restituisce in modo asincrono (tramite il metodo che genera l'evento GetPageNumberCompleted) il numero di pagina in base zero dell'oggetto ContentPosition specificato. |
| GetPageNumberAsync(ContentPosition, Object) |
Restituisce in modo asincrono (tramite il metodo che genera l'evento GetPageNumberCompleted) il numero di pagina in base zero dell'oggetto ContentPosition specificato. |
| GetPagePosition(DocumentPage) |
Quando sottoposto a override in una classe derivata, ottiene la posizione della pagina specificata nel contenuto del documento. |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnComputePageCountCompleted(AsyncCompletedEventArgs) |
Genera l'evento ComputePageCountCompleted. (Ereditato da DocumentPaginator) |
| OnGetPageCompleted(GetPageCompletedEventArgs) |
Genera l'evento GetPageCompleted. (Ereditato da DocumentPaginator) |
| OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs) |
Genera l'evento GetPageNumberCompleted. |
| OnPagesChanged(PagesChangedEventArgs) |
Genera l'evento PagesChanged. (Ereditato da DocumentPaginator) |
| OnPaginationCompleted(EventArgs) |
Genera l'evento PaginationCompleted. |
| OnPaginationProgress(PaginationProgressEventArgs) |
Genera l'evento PaginationProgress. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
| ComputePageCountCompleted |
Si verifica quando viene completata un'operazione dell'elemento ComputePageCountAsync. (Ereditato da DocumentPaginator) |
| GetPageCompleted |
Si verifica al completamento di GetPageAsync. (Ereditato da DocumentPaginator) |
| GetPageNumberCompleted |
Si verifica al completamento di GetPageNumberAsync. |
| PagesChanged |
Si verifica in seguito alla modifica del contenuto del documento. (Ereditato da DocumentPaginator) |
| PaginationCompleted |
Si verifica quando tutto il contenuto del documento è stato impaginato. |
| PaginationProgress |
Si verifica quando una o più pagine di contenuto sono state impaginate. |
