Indicateurs de progression MAPI
S’applique à : Outlook 2013 | Outlook 2016
La plupart des opérations que vous effectuez pour les clients peuvent prendre beaucoup de temps. Pour informer les clients de la progression d’une opération longue, vous pouvez afficher un indicateur qui affiche sous forme graphique la partie terminée d’une opération à un moment donné, du début de l’opération jusqu’à sa fin. L’indicateur de progression indique un pourcentage de l’opération totale à effectuer.
Les méthodes suivantes prennent en charge les opérations longues et l’affichage d’un indicateur de progression :
IMAPIFolder ::CopyMessages, IMAPIFolder ::CopyFolder, IMAPIFolder ::D eleteMessages, IMAPIFolder ::D eleteFolder, IMAPIFolder ::EmptyFolder et IMAPIFolder ::SetReadFlags.
IMAPISupport ::D oCopyProps, IMAPISupport ::D oCopyTo, IMAPISupport ::CopyFolder et IMAPISupport ::CopyMessages.
Pour afficher un indicateur de progression, MAPI définit un objet progress. Les objets Progress implémentent l’interface IMAPIProgress : IUnknown , interface qui inclut des méthodes permettant d’établir la plage de l’indicateur et de créer l’affichage. MAPI fournit une implémentation d’objet de progression, comme le font certains clients. Vous devez utiliser l’implémentation d’un client, le cas échéant, comme paramètre d’entrée pour la méthode qui effectue l’opération. Si le client passe NULL au lieu d’un pointeur vers un objet progress, utilisez l’implémentation de MAPI en appelant la méthode IMAPISupport ::D oProgressDialog .