DynamicDocumentPaginator Clase

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationCore.dll

Proporciona una clase base abstracta que admite la paginación automática en segundo plano y el seguimiento de las posiciones del contenido en las repaginaciones, además de los métodos y propiedades de su propia clase 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

Herencia

Object

DocumentPaginator

DynamicDocumentPaginator

Comentarios

De forma predeterminada, un DynamicDocumentPaginator elemento paginará automáticamente el contenido en segundo plano (este proceso comienza cuando IsBackgroundPaginationEnabled es true, que es la configuración predeterminada).

Cuando IsBackgroundPaginationEnabled es true, el diseño también se volverá a paginar debido a cambios en el contenido o cambios en PageSize.

El PaginationProgress evento se produce tras la finalización de la paginación (o repaginación) de una o varias páginas, como en las situaciones siguientes:

• PaginationProgress los eventos se producen a medida que el contenido está paginado en segundo plano. Dependiendo de la implementación, el evento puede producirse al paginar una o varias páginas (PaginationProgressEventArgs especifica qué páginas se han paginado).

• Las llamadas a GetPage o GetPageAsync pueden provocar que se produzca un PaginationProgress evento si la página especificada no se ha paginado. Por ejemplo, si la paginación en segundo plano está habilitada (IsBackgroundPaginationEnabled = true), pero la paginación solo se ha completado hasta la tercera página, una llamada de GetPage con un argumento de 6 hará que las páginas cuatro, cinco, seis y siete se paginarán. Tras la finalización, se generará un PaginationProgress evento con PaginationProgressEventArgs la configuración de Start = 4 y Count = 4.

• Con la paginación en segundo plano habilitada (IsBackgroundPaginationEnabled = true), un cambio en PageSize el contenido en formato de flujo, como , FlowDocumentpuede provocar la repaginación y los eventos asociados.PaginationProgress Tenga en cuenta que PageSize no tiene ningún efecto en la repaginación en contenido de formato fijo, como FixedDocument, donde el tamaño de página visual no afecta al diseño.

Un PaginationCompleted evento también se produce cuando se deshabilita la paginación en segundo plano. Por ejemplo, si solo hay una página de contenido y IsBackgroundPaginationEnabled = false), al llamar GetPage con un argumento 0, se producirán dos eventos:

1. Evento PaginationProgress con PaginationProgressEventArgs la configuración de Start = 0 y Count = 1.

2. Un PaginationCompleted evento.

Constructores

DynamicDocumentPaginator()

Inicializa una nueva instancia de la clase DynamicDocumentPaginator.

Propiedades

IsBackgroundPaginationEnabled	Obtiene o establece un valor que indica si la paginación se realiza automáticamente en segundo plano en respuesta a algunos eventos, como un cambio en el tamaño de página.
IsPageCountValid	Cuando se invalida en una clase derivada, obtiene un valor que indica si PageCount es el número de páginas total. (Heredado de DocumentPaginator)
PageCount	Cuando se invalida en una clase derivada, obtiene un recuento del número de páginas a las que se ha dado formato actualmente. (Heredado de DocumentPaginator)
PageSize	Cuando se invalida en una clase derivada, obtiene o establece el ancho y el alto sugeridos de cada página. (Heredado de DocumentPaginator)
Source	Cuando se invalida en una clase derivada, devuelve el elemento que se está paginando. (Heredado de DocumentPaginator)

Métodos

CancelAsync(Object)	Cancela un GetPageAsync anterior u operación GetPageNumberAsync. (Heredado de DocumentPaginator)
ComputePageCount()	Fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true. (Heredado de DocumentPaginator)
ComputePageCountAsync()	De forma asincrónica, fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true. (Heredado de DocumentPaginator)
ComputePageCountAsync(Object)	De forma asincrónica, fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true. (Heredado de DocumentPaginator)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectPosition(Object)	Cuando se invalida en una clase derivada, devuelve ContentPosition para el Object especificado.
GetPage(Int32)	Cuando se invalida en una clase derivada, se obtiene DocumentPage para el número de página especificado. (Heredado de DocumentPaginator)
GetPageAsync(Int32)	De forma asincrónica, devuelve (mediante el evento GetPageCompleted) DocumentPage para el número de página especificado. (Heredado de DocumentPaginator)
GetPageAsync(Int32, Object)	De forma asincrónica, devuelve (mediante el evento GetPageCompleted) DocumentPage para el número de página especificado y asigna el Id. especificado a la tarea asincrónica. (Heredado de DocumentPaginator)
GetPageNumber(ContentPosition)	Cuando se invalida en una clase derivada, devuelve el número de página de base cero de la ContentPosition especificada.
GetPageNumberAsync(ContentPosition)	De forma asincrónica, devuelve (mediante este método que provoca el evento GetPageNumberCompleted) el número de página de base cero de la ContentPosition especificada.
GetPageNumberAsync(ContentPosition, Object)	De forma asincrónica, devuelve (mediante este método que provoca el evento GetPageNumberCompleted) el número de página de base cero de la ContentPosition especificada.
GetPagePosition(DocumentPage)	Cuando se invalida en una clase derivada, obtiene la posición de la página especificada en el contenido del documento.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Genera el evento ComputePageCountCompleted. (Heredado de DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Genera el evento GetPageCompleted. (Heredado de DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	Genera el evento GetPageNumberCompleted.
OnPagesChanged(PagesChangedEventArgs)	Genera el evento PagesChanged. (Heredado de DocumentPaginator)
OnPaginationCompleted(EventArgs)	Genera el evento PaginationCompleted.
OnPaginationProgress(PaginationProgressEventArgs)	Genera el evento PaginationProgress.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

ComputePageCountCompleted	Se produce al finalizar una operación ComputePageCountAsync. (Heredado de DocumentPaginator)
GetPageCompleted	Se produce al finalizar GetPageAsync. (Heredado de DocumentPaginator)
GetPageNumberCompleted	Se produce al finalizar GetPageNumberAsync.
PagesChanged	Se produce cuando se cambia el contenido del documento. (Heredado de DocumentPaginator)
PaginationCompleted	Se produce cuando se ha paginado todo el contenido del documento.
PaginationProgress	Se produce cuando se han paginado una o más páginas del contenido.