DynamicDocumentPaginator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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::DocumentPaginatorpublic abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginatortype DynamicDocumentPaginator = class
inherit DocumentPaginatorPublic MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator- Herencia
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:
Evento PaginationProgress con PaginationProgressEventArgs la configuración de Start = 0 y Count = 1.
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 |
| ComputePageCountAsync() |
De forma asincrónica, fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en |
| ComputePageCountAsync(Object) |
De forma asincrónica, fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en |
| 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. |
