DynamicDocumentPaginator.GetPageNumberAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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).
Aplica-se a
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.
Crie um GetPageNumberCompletedEventHandler delegado e adicione-o para ser notificado sobre GetPageNumberCompleted eventos.
Chame GetPageNumberAsync(ContentPosition, Object) especificando o
contentPosition
desejado e um objeto exclusivouserState
que será usado para identificar a tarefa assíncrona.Quando o evento ocorrer e o delegado for chamado, compare a propriedade . do evento com o parâmetro original
userState
GetPageNumberAsync.GetPageNumberCompletedEventArgsUserStateQuando 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
.)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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de