DynamicDocumentPaginator Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma classe base abstrata que suporta a paginação automática em segundo plano e o rastreio de posições de conteúdo através de repaginações, além dos métodos e propriedades da sua própria 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- Herança
Observações
Por defeito, o DynamicDocumentPaginator a pré-paga automaticamente o conteúdo em segundo plano (este processo começa quando IsBackgroundPaginationEnabled é true, que é a definição padrão).
Quando IsBackgroundPaginationEnabled for true, o layout também será repaginado devido a alterações no conteúdo ou alterações em PageSize.
O PaginationProgress evento ocorre após a conclusão da paginação (ou repaginação) de uma ou mais páginas, como nas seguintes situações:
PaginationProgress os eventos ocorrem enquanto o conteúdo é paginado em segundo plano. Dependendo da implementação, o evento pode ocorrer ao paginar uma ou várias páginas (PaginationProgressEventArgs especifica quais as páginas que foram paginadas).
Chamadas para GetPage ou GetPageAsync podem causar um PaginationProgress evento se a página especificada não tiver sido paginada. Por exemplo, se a paginação em segundo plano estiver ativada (IsBackgroundPaginationEnabled =
true) mas a paginação só tiver sido concluída até à terceira página, uma chamada de GetPage com argumento 6 fará com que as páginas quatro, cinco, seis e sete sejam paginadas. Após a conclusão, será criado um PaginationProgress evento com PaginationProgressEventArgs definições de Start = 4 e Count = 4.Com a paginação em segundo plano ativada (IsBackgroundPaginationEnabled =
true), uma alteração no PageSize conteúdo do formato de fluxo, como um FlowDocument, pode causar repaginação e eventos associados.PaginationProgress Note que PageSize não tem efeito na repaginação em conteúdos de formato fixo, como FixedDocument, onde o tamanho visual da página não afeta o layout.
Um evento também ocorre quando a PaginationCompleted paginação em segundo plano está desativada. Por exemplo, se houver apenas uma página de conteúdo e IsBackgroundPaginationEnabled = false), chamar GetPage com um argumento 0 resultará em dois eventos:
Um PaginationProgress evento com PaginationProgressEventArgs definições de Start = 0 e Count = 1.
Um PaginationCompleted evento.
Construtores
| Name | Description |
|---|---|
| DynamicDocumentPaginator() |
Inicializa uma nova instância da DynamicDocumentPaginator classe. |
Propriedades
| Name | Description |
|---|---|
| IsBackgroundPaginationEnabled |
Recebe ou define um valor que indica se a paginação é realizada automaticamente em segundo plano em resposta a certos eventos, como uma alteração no tamanho da página. |
| IsPageCountValid |
Quando sobrescrito numa classe derivada, obtém um valor que indica se PageCount é o número total de páginas. (Herdado de DocumentPaginator) |
| PageCount |
Quando sobrescrito numa classe derivada, obtém uma contagem do número de páginas atualmente formatadas. (Herdado de DocumentPaginator) |
| PageSize |
Quando sobrescrito numa classe derivada, obtém ou define a largura e altura sugeridas de cada página. (Herdado de DocumentPaginator) |
| Source |
Quando sobrescrito numa classe derivada, devolve o elemento que está a ser paginado. (Herdado de DocumentPaginator) |
Métodos
| Name | Description |
|---|---|
| CancelAsync(Object) |
Cancela uma operação anterior GetPageAsyncGetPageNumberAsync ou uma operação. (Herdado de DocumentPaginator) |
| ComputePageCount() |
Força a paginação do conteúdo, atualiza PageCount com o novo total e define IsPageCountValid para |
| ComputePageCountAsync() |
Assíncronamente, força a paginação do conteúdo, atualiza PageCount com o novo total e define IsPageCountValid para |
| ComputePageCountAsync(Object) |
Assíncronamente, força a paginação do conteúdo, atualiza PageCount com o novo total, define IsPageCountValid para |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectPosition(Object) |
Quando sobrescrito numa classe derivada, retorna a ContentPosition para o especificado Object. |
| GetPage(Int32) |
Quando sobrescrito numa classe derivada, obtém o DocumentPage para o número de página especificado. (Herdado de DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Retorna assíncronamente (através do GetPageCompleted evento) o DocumentPage para o número de página especificado e atribui o ID especificado à tarefa assíncrona. (Herdado de DocumentPaginator) |
| GetPageAsync(Int32) |
Devolve assíncronamente (através do GetPageCompleted evento) o DocumentPage para o número de página especificado. (Herdado de DocumentPaginator) |
| GetPageNumber(ContentPosition) |
Quando sobrescrito numa classe derivada, devolve o número de página baseado em zero do especificado ContentPosition. |
| GetPageNumberAsync(ContentPosition, Object) |
Assíncrono, retorna (através de Este método eleva o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition. |
| GetPageNumberAsync(ContentPosition) |
Assíncrono, retorna (através de Este método eleva o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition. |
| GetPagePosition(DocumentPage) |
Quando sobreposto numa classe derivada, obtém a posição da página especificada no conteúdo do documento. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnComputePageCountCompleted(AsyncCompletedEventArgs) |
Eleva o ComputePageCountCompleted evento. (Herdado de DocumentPaginator) |
| OnGetPageCompleted(GetPageCompletedEventArgs) |
Eleva o GetPageCompleted evento. (Herdado de DocumentPaginator) |
| OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs) |
Eleva o GetPageNumberCompleted evento. |
| OnPagesChanged(PagesChangedEventArgs) |
Eleva o PagesChanged evento. (Herdado de DocumentPaginator) |
| OnPaginationCompleted(EventArgs) |
Eleva o PaginationCompleted evento. |
| OnPaginationProgress(PaginationProgressEventArgs) |
Eleva o PaginationProgress evento. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
evento
| Name | Description |
|---|---|
| ComputePageCountCompleted |
Ocorre quando uma ComputePageCountAsync operação termina. (Herdado de DocumentPaginator) |
| GetPageCompleted |
Ocorre quando GetPageAsync está concluído. (Herdado de DocumentPaginator) |
| GetPageNumberCompleted |
Ocorre quando GetPageNumberAsync está concluído. |
| PagesChanged |
Ocorre quando o conteúdo do documento é alterado. (Herdado de DocumentPaginator) |
| PaginationCompleted |
Ocorre quando todo o conteúdo do documento foi paginado. |
| PaginationProgress |
Ocorre quando uma ou mais páginas de conteúdo foram paginadas. |