DynamicDocumentPaginator.GetPageNumberAsync Método

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

Retorna o número de página de base zero do ContentPosition especificado.

Sobrecargas

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.

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.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parâmetros

contentPosition

ContentPosition

A posição do conteúdo cujo número de página é necessário.

Comentários

A única maneira de cancelar a operação assíncrona desse método é cancelar todas as operações assíncronas. Compare isso com a outra sobrecarga deste método: GetPageNumberAsync(ContentPosition, Object).

Esse método gera o GetPageNumberCompleted evento . O número da página é passado para o evento como um dos argumentos de evento. Confira GetPageNumberAsync(ContentPosition, Object) como usar esse método para obter o número da página.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por GetPageNumber(ContentPosition).

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.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parâmetros

contentPosition

ContentPosition

O elemento da posição do conteúdo do qual retornar o número da página.

userState

Object

Um identificador exclusivo para a tarefa assíncrona.

Comentários

Essa sobrecarga do método possibilita cancelar essa operação assíncrona sem cancelar todas as operações assíncronas.

Esse método gera o GetPageNumberCompleted evento .

As etapas a seguir ilustram como recuperar o número de página de um determinado contentPosition de forma assíncrona.

1. Crie um GetPageNumberCompletedEventHandler delegado e adicione-o para ser notificado sobre GetPageNumberCompleted eventos.

2. Chame GetPageNumberAsync(ContentPosition, Object) especificando o contentPosition desejado e um objeto exclusivo userState que será usado para identificar a tarefa assíncrona.

3. Quando o evento ocorrer e o delegado for chamado, compare a propriedade . do evento com o parâmetro originaluserStateGetPageNumberAsync.GetPageNumberCompletedEventArgsUserState

4. Quando a GetPageNumberCompletedEventArgspropriedade .UserState corresponde ao original GetPageNumberAsync(ContentPosition, Object)userState, a operação é concluída e o número da página está pronto. (A GetPageNumberCompletedEventArgspropriedade .ContentPosition também corresponderá ao parâmetro original GetPageNumberAsync(ContentPosition, Object)contentPosition .)

5. A GetPageNumberCompletedEventArgspropriedade .PageNumber contém o número de página baseado em zero do especificado contentPosition.

GetPageNumber fornece funcionalidade semelhante a GetPageNumberAsync, mas para operação síncrona.