DynamicDocumentPaginator Classe

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

Fornece uma classe base abstrata que dá suporte às posições de conteúdo de acompanhamento e paginação em segundo plano automática nas repaginações além dos métodos e propriedades de sua própria 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

Herança

Object

DocumentPaginator

DynamicDocumentPaginator

Comentários

Por padrão, um DynamicDocumentPaginator pré-paginará automaticamente o conteúdo em segundo plano (esse processo começa quando IsBackgroundPaginationEnabled é true, que é a configuração padrão).

Quando IsBackgroundPaginationEnabled for true, o layout também será repaginado devido a alterações no conteúdo ou alterações no PageSize.

O PaginationProgress evento ocorre após a conclusão da paginação (ou reaginação) de uma ou mais páginas, como nas seguintes situações:

• PaginationProgress os eventos ocorrem à medida que o conteúdo é paginado em segundo plano. Dependendo da implementação, o evento pode ocorrer após paginar uma ou várias páginas (PaginationProgressEventArgs especifica quais páginas foram paginadas).

• Chamadas para GetPage ou GetPageAsync podem fazer com que um PaginationProgress evento ocorra se a página especificada não tiver sido paginada. Por exemplo, se a paginação em segundo plano estiver habilitada (IsBackgroundPaginationEnabled = true), mas a paginação tiver sido concluída apenas até a terceira página, uma chamada com GetPage um argumento de 6 fará com que as páginas quatro, cinco, seis e sete sejam paginadas. Após a conclusão, um PaginationProgress evento será gerado com PaginationProgressEventArgs configurações de Start = 4 e Count = 4.

• Com a paginação em segundo plano habilitada (IsBackgroundPaginationEnabled = true), uma alteração no conteúdo de PageSize formato de fluxo, como um FlowDocument, pode causar reaginação e eventos associados.PaginationProgress Observe que não tem efeito na reaginação no conteúdo de formato fixo, como FixedDocument, em que PageSize o tamanho da página visual não afeta o layout.

Um PaginationCompleted evento também ocorre quando a paginação em segundo plano é desabilitada. Por exemplo, se houver apenas uma página de conteúdo e IsBackgroundPaginationEnabled = false), chamar GetPage com um argumento de 0 resultará em dois eventos:

1. Um PaginationProgress evento com PaginationProgressEventArgs configurações de Start = 0 e Count = 1.

2. Um PaginationCompleted evento.

Construtores

DynamicDocumentPaginator()

Inicializa uma nova instância da classe DynamicDocumentPaginator.

Propriedades

IsBackgroundPaginationEnabled	Obtém ou define um valor que indica se a paginação é executada automaticamente em segundo plano em resposta a determinados eventos, como uma alteração no tamanho da página.
IsPageCountValid	Quando substituído em uma classe derivada, obtém um valor que indica se PageCount é o número total de páginas. (Herdado de DocumentPaginator)
PageCount	Quando substituído em uma classe derivada, obtém uma contagem do número de páginas atualmente formatadas. (Herdado de DocumentPaginator)
PageSize	Quando substituído em uma classe derivada, obtém ou define a largura e altura sugeridas de cada página. (Herdado de DocumentPaginator)
Source	Quando substituído em uma classe derivada, retorna o elemento sendo paginado. (Herdado de DocumentPaginator)

Métodos

CancelAsync(Object)	Cancela uma operação GetPageAsync ou GetPageNumberAsync anterior. (Herdado de DocumentPaginator)
ComputePageCount()	Força uma paginação do conteúdo, atualiza PageCount com o novo total e define IsPageCountValid como true. (Herdado de DocumentPaginator)
ComputePageCountAsync()	De forma assíncrona, força uma paginação do conteúdo, atualiza PageCount com o novo total e define IsPageCountValid como true. (Herdado de DocumentPaginator)
ComputePageCountAsync(Object)	De forma assíncrona, força uma paginação do conteúdo, atualiza PageCount com o novo total, define IsPageCountValid como true. (Herdado de DocumentPaginator)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectPosition(Object)	Quando substituído em uma classe derivada, retorna um ContentPosition para o Object especificado.
GetPage(Int32)	Quando substituído em uma classe derivada, obtém o DocumentPage para o número de páginas especificado. (Herdado de DocumentPaginator)
GetPageAsync(Int32)	Retorna de maneira assíncrona (por meio do evento GetPageCompleted) a DocumentPage para o número de página especificado. (Herdado de DocumentPaginator)
GetPageAsync(Int32, Object)	Retorna de maneira assíncrona (por meio do evento GetPageCompleted) a DocumentPage para o número de página especificado e atribui a ID especificada à tarefa assíncrona. (Herdado de DocumentPaginator)
GetPageNumber(ContentPosition)	Quando substituído em uma classe derivada, retorna o número de página de base zero do ContentPosition especificado.
GetPageNumberAsync(ContentPosition)	De forma assíncrona, retorna (por meio Este método gera um evento GetPageNumberCompleted) o número de página de base zero do ContentPosition especificado.
GetPageNumberAsync(ContentPosition, Object)	De forma assíncrona, retorna (por meio Este método gera um evento GetPageNumberCompleted) o número de página de base zero do ContentPosition especificado.
GetPagePosition(DocumentPage)	Quando substituído em uma 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 Object atual. (Herdado de Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Aciona o evento ComputePageCountCompleted. (Herdado de DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Aciona o evento GetPageCompleted. (Herdado de DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	Aciona o evento GetPageNumberCompleted.
OnPagesChanged(PagesChangedEventArgs)	Aciona o evento PagesChanged. (Herdado de DocumentPaginator)
OnPaginationCompleted(EventArgs)	Aciona o evento PaginationCompleted.
OnPaginationProgress(PaginationProgressEventArgs)	Aciona o evento PaginationProgress.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

ComputePageCountCompleted	Ocorre quando uma operação ComputePageCountAsync foi concluída. (Herdado de DocumentPaginator)
GetPageCompleted	Ocorre quando GetPageAsync é concluído. (Herdado de DocumentPaginator)
GetPageNumberCompleted	Ocorre quando GetPageNumberAsync é 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.