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 e il rilevamento automatico delle posizioni del contenuto in background tra repaginazioni oltre ai metodi e alle proprietà della propria classe di 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 oggetto DynamicDocumentPaginator preagina automaticamente il contenuto in background (questo processo inizia quando IsBackgroundPaginationEnabled è true, ovvero l'impostazione predefinita).
Quando IsBackgroundPaginationEnabled è true, anche il layout verrà riginato a causa di modifiche apportate al contenuto o alle modifiche in PageSize.
L'evento PaginationProgress si verifica al completamento della paginazione (o della riproduzione) 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 paginazione di una o più pagine (PaginationProgressEventArgs specifica le pagine impaginate).
Le chiamate a GetPage o GetPageAsync possono causare un PaginationProgress evento se la pagina specificata non è stata impaginata. Ad esempio, se l'impaginazione in background è abilitata (IsBackgroundPaginationEnabled =
true) ma l'impaginazione è stata completata solo fino alla terza pagina, una chiamata di GetPage con un argomento di 6 causerà la paginazione di quattro, cinque, sei e sette pagine da impaginare. 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 contenuto in PageSize formato flusso, ad esempio , FlowDocumentpuò causare la riproduzione e gli eventi associati.PaginationProgress Si noti che PageSize non ha alcun effetto nella riproduzione del contenuto in formato fisso, ad esempio FixedDocument, in cui le dimensioni della pagina visiva non influiscono sul layout.
Un PaginationCompleted evento si verifica anche quando l'impaginazione in background è disabilitata. Ad esempio, se è presente una sola pagina di contenuto e IsBackgroundPaginationEnabled = false), la chiamata GetPage con un argomento 0 comporterà due eventi:
Evento PaginationProgress con PaginationProgressEventArgs impostazioni = Start 0 e Count = 1.
Evento PaginationCompleted .
Costruttori
| Nome | Descrizione |
|---|---|
| DynamicDocumentPaginator() |
Inizializza una nuova istanza della classe DynamicDocumentPaginator. |
Proprietà
| Nome | Descrizione |
|---|---|
| IsBackgroundPaginationEnabled |
Ottiene o imposta un valore che indica se l'impaginazione viene eseguita automaticamente in background in risposta a determinati eventi, ad esempio una modifica delle dimensioni della pagina. |
| IsPageCountValid |
In caso di override in una classe derivata, ottiene un valore che indica se PageCount è il numero totale di pagine. (Ereditato da DocumentPaginator) |
| PageCount |
Quando sottoposto a override in una classe derivata, ottiene un conteggio del numero di pagine attualmente formattate. (Ereditato da DocumentPaginator) |
| PageSize |
In caso di override in una classe derivata, ottiene o imposta la larghezza e l'altezza suggerite di ogni pagina. (Ereditato da DocumentPaginator) |
| Source |
Quando sottoposto a override in una classe derivata, restituisce l'elemento impaginato. (Ereditato da DocumentPaginator) |
Metodi
| Nome | Descrizione |
|---|---|
| CancelAsync(Object) |
Annulla un'operazione o GetPageAsync precedenteGetPageNumberAsync. (Ereditato da DocumentPaginator) |
| ComputePageCount() |
Forza una paginazione del contenuto, gli aggiornamenti PageCount con il nuovo totale e imposta IsPageCountValid su |
| ComputePageCountAsync() |
Forza in modo asincrono un'impaginazione del contenuto, gli aggiornamenti PageCount con il nuovo totale e imposta IsPageCountValid su |
| ComputePageCountAsync(Object) |
In modo asincrono, forza una paginazione del contenuto, gli aggiornamenti PageCount con il nuovo totale, 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 ContentPosition oggetto per l'oggetto specificato Object. |
| GetPage(Int32) |
In caso di override in una classe derivata, ottiene l'oggetto DocumentPage per il numero di pagina specificato. (Ereditato da DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) per DocumentPage il numero di pagina specificato e assegna l'ID specificato all'attività asincrona. (Ereditato da DocumentPaginator) |
| GetPageAsync(Int32) |
Restituisce in modo asincrono (tramite l'evento) l'oggetto GetPageCompletedDocumentPage per il numero di pagina specificato. (Ereditato da DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Quando sottoposto a override in una classe derivata, restituisce il numero di pagina in base zero dell'oggetto specificato ContentPosition. |
| GetPageNumberAsync(ContentPosition, Object) |
In modo asincrono, restituisce (tramite il metodo This genera l'evento GetPageNumberCompleted ) il numero di pagina in base zero dell'oggetto specificato ContentPosition. |
| GetPageNumberAsync(ContentPosition) |
In modo asincrono, restituisce (tramite il metodo This genera l'evento GetPageNumberCompleted ) il numero di pagina in base zero dell'oggetto specificato ContentPosition. |
| GetPagePosition(DocumentPage) |
In caso di override in una classe derivata, ottiene la posizione della pagina specificata nel contenuto del documento. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (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
| Nome | Descrizione |
|---|---|
| ComputePageCountCompleted |
Si verifica al termine di un'operazione ComputePageCountAsync . (Ereditato da DocumentPaginator) |
| GetPageCompleted |
Si verifica al GetPageAsync termine dell'operazione. (Ereditato da DocumentPaginator) |
| GetPageNumberCompleted |
Si verifica al GetPageNumberAsync termine dell'operazione. |
| PagesChanged |
Si verifica quando il contenuto del documento viene modificato. (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. |
