IMAPIViewContext::GetViewStatus
S’applique à : Outlook 2013 | Outlook 2016
Récupère la visionneuse actuelle status.
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
Paramètres
lpulStatus
[out] Pointeur vers un masque de bits d’indicateurs fournissant la status de la visionneuse. Les indicateurs suivants peuvent être définis :
VCSTATUS_CATEGORY
Il y a un message suivant ou précédent dans une autre catégorie.
VCSTATUS_DELETE
Le formulaire permet de supprimer les messages.
VCSTATUS_INTERACTIVE
Le formulaire doit afficher une interface utilisateur. Si cet indicateur n’est pas défini, le formulaire doit supprimer l’affichage d’une interface utilisateur, même en réponse à un verbe qui provoque généralement l’affichage d’une interface utilisateur.
VCSTATUS_MODAL
Le formulaire est modal pour la visionneuse.
VCSTATUS_NEXT
Un message suivant apparaît dans la vue.
VCSTATUS_PREV
Il y a un message précédent dans la vue.
VCSTATUS_READONLY
Le message doit être ouvert en mode lecture seule. Les opérations de suppression, d’envoi et de déplacement doivent être désactivées.
VCSTATUS_UNREAD
La vue comporte un message non lu suivant ou précédent.
Valeur renvoyée
S_OK
La status de la visionneuse a été retournée avec succès.
Remarques
Les objets formulaire appellent la méthode IMAPIViewContext ::GetViewStatus pour déterminer s’il y a plus de messages à activer dans un mode formulaire dans l’une ou l’autre direction, c’est-à-dire dans la direction dans laquelle une commande Next active les messages, dans la direction dans laquelle une commande Previous active les messages, ou dans les deux directions. La valeur pointée par le paramètre lpulStatus est utilisée pour déterminer si les indicateurs VCSTATUS_NEXT et VCSTATUS_PREV sont valides pour IMAPIViewContext ::ActivateNext. Si l’indicateur VCSTATUS_DELETE est défini, mais pas l’indicateur VCSTATUS_READONLY, le message peut être supprimé à l’aide de la méthode IMAPIMessageSite ::D eleteMessage .
En règle générale, les formulaires désactivent les commandes de menu et les boutons s’ils ne sont pas valides pour le contexte de la visionneuse. Une visionneuse peut alerter un formulaire d’une modification dans status en appelant sa méthode IMAPIFormAdviseSink ::OnChange.
L’indicateur VCSTATUS_MODAL est défini si le formulaire doit être modal pour la fenêtre dont le handle est passé dans l’appel IMAPIForm ::D oVerb précédent. Si VCSTATUS_MODAL est défini, le formulaire peut utiliser le thread sur lequel l’appel DoVerb a été effectué jusqu’à ce que le formulaire se ferme. Si VCSTATUS_MODAL n’est pas défini, le formulaire ne doit pas être modal pour cette fenêtre et ne doit pas utiliser le thread.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer ::GetViewStatus |
MFCMAPI implémente la méthode IMAPIViewContext ::GetViewStatus dans cette fonction. |