Partager via

IMAPIViewContext::ActivateNext

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Active le message suivant ou précédent dans l’ordre d’affichage.

HRESULT ActivateNext(
ULONG ulDir,
LPCRECT prcPosRect
);

Paramètres

ulDir

[in] Indicateurs d’état donnant des informations sur le message à activer. Les paramètres d’indicateur valides sont les suivants :

  • VCDIR_CATEGORY : la visionneuse doit activer un message dans une autre catégorie de l’affichage. Le message à activer est le suivant :

    • Premier message de la catégorie d’affichage suivante si cet indicateur est ORavec VCDIR_NEXT.

    • Dernier message de la catégorie d’affichage précédente si cet indicateur est ORavec VCDIR_PREV et que la catégorie précédente est développée.

    • Premier message de la catégorie d’affichage précédente si cet indicateur est ORavec VCDIR_PREV et que la catégorie précédente n’est pas développée. Dans ce cas, la catégorie précédente subit une expansion automatique.

  • VCDIR_DELETE : la visionneuse doit activer le message suivant ou précédent, car le message actuel a été supprimé.

  • VCDIR_MOVE : la visionneuse doit activer le message suivant ou précédent, car le message actuel a été déplacé.

  • VCDIR_NEXT : la visionneuse doit activer le message suivant dans l’ordre d’affichage.

  • VCDIR_PREV : la visionneuse doit activer le message précédent dans l’ordre d’affichage.

  • VCDIR_UNREAD : la visionneuse doit activer le message non lu suivant ou précédent dans l’ordre d’affichage.

prcPosRect

[in] Pointeur vers une structure RECT Windows contenant la taille et la position de la fenêtre à utiliser pour afficher le message activé.

Valeur renvoyée

S_OK

Le message a été activé avec succès.

S_FALSE

Le message a été activé avec succès, mais un autre type de formulaire a été ouvert dans le processus.

Remarques

Les objets de formulaire appellent la méthode IMAPIViewContext ::ActivateNext pour modifier le message affiché à l’utilisateur. La valeur passée dans le paramètre ulDir indique quel message doit être activé et, dans certains cas, pourquoi. Les indicateurs VCDIR_NEXT et VCDIR_PREVIOUS correspondent aux utilisateurs choisissant respectivement la commande Suivant ou Précédent dans une vue. Ces opérations correspondent généralement au déplacement vers le haut ou le bas d’un message dans la liste des messages de la visionneuse de formulaire.

Les indicateurs VCDIR_DELETE et VCDIR_MOVE sont définis par les méthodes IMAPIMessageSite ::D eleteMessage et IMAPIMessageSite ::MoveMessage , respectivement. Les implémentations de ces méthodes appellent ActivateNext avec la direction appropriée, puis effectuent l’opération demandée sur le message si l’appel ActivateNext n’a pas échoué. Les visionneuses de formulaires permettent généralement aux utilisateurs de spécifier la direction de déplacement dans la liste des messages.

Remarques pour les responsables de l’implémentation

Votre implémentation de IMAPIViewContext ::ActivateNext affiche le message suivant ou précédent dans le dossier, en fonction de la valeur de ulDir, le message actuel. Après le retour de ActivateNext , appelez IMAPIMessageSite ::GetMessage pour obtenir un pointeur vers le message nouvellement activé.

Remarques pour les appelants

Si ActivateNext renvoie S_FALSE, ou si un message actuel n’est pas présent, effectuez votre procédure d’arrêt normale, qui doit inclure l’appel de la méthode IMAPIForm ::ShutdownForm de votre formulaire. Si un message suivant ou précédent s’affiche, utilisez le rectangle de fenêtre passé dans le paramètre prcPosRect pour l’afficher.

Référence MFCMAPI

Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.

Fichier Fonction Commentaire
MyMAPIFormViewer.cpp
 CMyMAPIFormViewer ::ActivateNext
 MFCMAPI implémente la méthode IMAPIViewContext ::ActivateNext dans cette fonction.

Voir aussi