DynamicDocumentPaginator Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Documents

Assembly:: PresentationCore.dll

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::DocumentPaginator

public abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginator

type DynamicDocumentPaginator = class
    inherit DocumentPaginator

Public MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator

Ereditarietà: Object

DocumentPaginator
DynamicDocumentPaginator

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 `true`. (Ereditato da DocumentPaginator)
ComputePageCountAsync()	Forza in modo asincrono un'impaginazione del contenuto, aggiorna PageCount con il nuovo totale e imposta IsPageCountValid su `true`. (Ereditato da DocumentPaginator)
ComputePageCountAsync(Object)	Forza in modo asincrono un'impaginazione del contenuto, aggiorna PageCount con il nuovo totale e imposta IsPageCountValid su `true`. (Ereditato da DocumentPaginator)
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.

Si applica a