DynamicDocumentPaginator.GetPageNumberAsync Método

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

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

Sobrecargas

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

GetPageNumberAsync(ContentPosition)

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

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 evento GetPageNumberCompleted. O número da página é passado para o evento como um dos argumentos do evento. Consulte GetPageNumberAsync(ContentPosition, Object) de 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 evento GetPageNumberCompleted) o número de página baseado em zero do ContentPositionespecificado.

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 evento GetPageNumberCompleted.

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

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

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

3. Quando o evento ocorre e o delegado é chamado, compare o GetPageNumberCompletedEventArgsdo evento.UserState propriedade com o parâmetro de GetPageNumberAsyncuserState original.

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

5. O GetPageNumberCompletedEventArgs.PageNumber propriedade contém o número de página baseado em zero do contentPositionespecificado.

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