Partager via

Envoi et réception de notifications par formulaire

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Les notifications de formulaire sont utilisées dans MAPI pour faciliter la communication entre le formulaire et votre visionneuse et le formulaire.

Les formulaires envoient des notifications à votre visionneuse lorsque l’un des événements suivants se produit :

  • Le formulaire est fermé.

  • Un nouveau message est chargé dans le formulaire.

  • Une opération d’enregistrement est terminée.

  • Un message est envoyé.

Chacun de ces types d’événements correspond à une méthode particulière dans IMAPIViewAdviseSink : IUnknown, l’une des interfaces que votre visionneuse de formulaires doit implémenter. Lorsqu’un événement se produit, le formulaire appelle la méthode IMAPIViewAdviseSink correspondante dans le récepteur de conseil de votre visionneuse. Par exemple, lorsqu’un nouveau message arrive que votre visionneuse doit inclure dans son affichage, le formulaire appelle votre méthode IMAPIViewAdviseSink ::OnNewMessage .

Implémentez votre récepteur de conseil d’affichage d’une manière logique pour votre visionneuse ; il n’existe aucune implémentation standard. Par exemple, dans OnNewMessage , vous pouvez mettre à jour l’affichage de la table du contenu du dossier actif pour inclure le message qui vient d’arriver. Dans IMAPIViewAdviseSink ::OnSubmitted, la méthode appelée lorsque vous recevez un événement de message envoyé, vous pouvez copier le message envoyé dans un dossier Éléments envoyés.

Les formulaires reçoivent une notification de votre visionneuse lorsqu’une modification se produit et que vous chargez un nouveau message. Pour notifier un formulaire, appelez l’une des méthodes de IMAPIFormAdviseSink : IMAPIFormAdviseSink ::OnChange ou IMAPIFormAdviseSink ::OnActivateNext. Appelez OnChange pour communiquer status. Par exemple, si le formulaire affiche le dernier élément d’un dossier lorsqu’un nouveau message arrive, appelez OnChange avec l’indicateur VCSTATUS_NEXT défini pour indiquer au formulaire qu’il existe désormais un élément suivant.

Appelez OnActivateNext pour avertir le formulaire de l’arrivée d’un nouveau message qu’il peut ou non être en mesure d’afficher. Transmettez la classe de message du message à OnActivateNext.

Les notifications par un objet de formulaire à l’application cliente sont gérées par l’interface IMAPIViewAdviseSink de l’application cliente. Pour plus d’informations, consultez IMAPIViewAdviseSink : IUnknown.