DynamicDocumentPaginator.GetPageNumberAsync Método

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

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

Sobrecargas

Nome	Description
GetPageNumberAsync(ContentPosition)	De forma assíncrona, retorna (por meio do método This gera o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition.
GetPageNumberAsync(ContentPosition, Object)	De forma assíncrona, retorna (por meio do método This gera o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition.

GetPageNumberAsync(ContentPosition)

De forma assíncrona, retorna (por meio do método This gera o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition.

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. Contraste 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 do evento. Veja 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 o equivalente síncrono 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 do método This gera o GetPageNumberCompleted evento) o número de página baseado em zero do especificado ContentPosition.

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 de posição de 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 uma determinada contentPosition maneira assíncrona.

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

2. Chame GetPageNumberAsync(ContentPosition, Object) especificando o contentPosition objeto 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.