Partager via


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.

Voir aussi

MFCMAPI comme un exemple de Code

Interfaces MAPI