IMAPIProgress : IUnknown
S’applique à : Outlook 2013 | Outlook 2016
Implémente un objet de progression qui fournit aux applications clientes un indicateur de progression. Un indicateur de progression est un affichage de l’interface utilisateur qui affiche le pourcentage d’achèvement d’une opération, telle que la copie de dossiers entre des banques de messages. Les applications clientes et MAPI implémentent des objets de progression et les fournisseurs de services les utilisent.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
| Exposé par : |
Objets de progression |
| Implémenté par : |
MAPI et applications clientes |
| Appelé par : |
Fournisseurs de services |
| Identificateur d’interface : |
IID_IMAPIProgress |
| Type de pointeur : |
LPMAPIPROGRESS |
Ordre de la table de Vtable
| Member | Description |
|---|---|
|
Progress |
Mises à jour l’indicateur de progression avec un affichage de la progression à mesure qu’elle est effectuée vers la fin de l’opération. |
|
GetFlags |
Retourne les paramètres d’indicateur de l’objet progress pour le niveau d’opération sur lequel les informations de progression sont calculées. |
|
GetMax |
Retourne le nombre maximal d’éléments de l’opération pour lesquels les informations de progression sont affichées. |
|
GetMin |
Retourne la valeur minimale de la méthode SetLimits pour laquelle les informations de progression sont affichées. |
|
SetLimits |
Définit les limites inférieure et supérieure du nombre d’éléments dans l’opération, ainsi que les indicateurs qui contrôlent la façon dont les informations de progression sont calculées pour l’opération. |
Remarques
MAPI inclut un paramètre lpProgress dans de nombreuses méthodes qui effectuent des opérations potentiellement longues. lpProgress pointe vers une implémentation cliente d’un objet progress. Les clients qui implémentent l’interface IMAPIProgress définissent ce paramètre pour qu’il pointe vers leur implémentation . les clients qui n’implémentent pas IMAPIProgress définissent le paramètre sur NULL. Pour afficher un indicateur de progression pendant le traitement de l’opération, les fournisseurs de services utilisent l’objet progress fourni par le client, le cas échéant, ou une implémentation MAPI (indiquée lorsque lpProgress a la valeur NULL).
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Files | Fonction | Commentaire |
|---|---|---|
| MapiProgress.h et MapiProgress.cpp |
Non applicable |
Si le paramètre IMAPIProgress est activé, MFCMAPI transmet une implémentation IMAPIProgress à toutes les fonctions appelées par MFCMAPI qui acceptent une implémentation. |