DynamicDocumentPaginator.GetPageNumberAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne le numéro de page de base zéro de la ContentPosition spécifiée.
Surcharges
GetPageNumberAsync(ContentPosition) |
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée. |
GetPageNumberAsync(ContentPosition, Object) |
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée. |
GetPageNumberAsync(ContentPosition)
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée.
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)
Paramètres
- contentPosition
- ContentPosition
Position de contenu dont le numéro de page est demandé.
Remarques
La seule façon d’annuler l’opération asynchrone de cette méthode consiste à annuler toutes les opérations asynchrones. Comparez cela avec l’autre surcharge de cette méthode : GetPageNumberAsync(ContentPosition, Object).
Cette méthode déclenche l’événement GetPageNumberCompleted . Le numéro de page est passé à l’événement comme l’un des arguments de l’événement. Consultez GetPageNumberAsync(ContentPosition, Object) pour savoir comment utiliser cette méthode pour obtenir le numéro de page.
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetPageNumber(ContentPosition).
S’applique à
GetPageNumberAsync(ContentPosition, Object)
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée.
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)
Paramètres
- contentPosition
- ContentPosition
Élément de position de contenu dont le numéro de page doit être retourné.
- userState
- Object
Identificateur unique de la tâche asynchrone.
Remarques
Cette surcharge de la méthode permet d’annuler cette opération asynchrone sans annuler toutes les opérations asynchrones.
Cette méthode déclenche l’événement GetPageNumberCompleted .
Les étapes suivantes illustrent comment récupérer le numéro de page d’une donnée contentPosition
de manière asynchrone.
Créez un GetPageNumberCompletedEventHandler délégué et ajoutez-le pour être averti des GetPageNumberCompleted événements.
Appel GetPageNumberAsync(ContentPosition, Object) spécifiant le
contentPosition
souhaité et un objet uniqueuserState
qui sera utilisé pour identifier la tâche asynchrone.Lorsque l’événement se produit et que le délégué est appelé, comparez la propriété . de GetPageNumberCompletedEventArgsl’événement avec le paramètre d’origineGetPageNumberAsync
userState
.UserStateLorsque la GetPageNumberCompletedEventArgspropriété .UserState correspond à l’original GetPageNumberAsync(ContentPosition, Object)
userState
, l’opération est terminée et le numéro de page est prêt. (La GetPageNumberCompletedEventArgspropriété .ContentPosition correspond également au paramètre d’origine GetPageNumberAsync(ContentPosition, Object)contentPosition
.)La GetPageNumberCompletedEventArgspropriété .PageNumber contient le numéro de page de base zéro du spécifié
contentPosition
.
GetPageNumber fournit des fonctionnalités similaires à GetPageNumberAsync, mais pour les opérations synchrones.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour