IMAPIForm::SetViewContext
S’applique à : Outlook 2013 | Outlook 2016
Établit un contexte d’affichage pour le formulaire.
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
Paramètres
pViewContext
[in] Pointeur vers le nouveau contexte d’affichage du formulaire.
Valeur renvoyée
S_OK
Le contexte d’affichage a été correctement défini.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIForm ::SetViewContext pour établir un contexte de mode formulaire particulier comme étant actuel. Un formulaire ne peut avoir qu’un seul contexte d’affichage à la fois.
Remarques pour les responsables de l’implémentation
La plupart des serveurs de formulaires implémentent SetViewContext à l’aide de l’algorithme suivant :
S’il existe déjà un contexte d’affichage pour le formulaire, annulez l’inscription du formulaire en appelant la méthode IMAPIViewContext ::SetAdviseSink avec null dans le paramètre pmnvs , puis appelez la méthode IUnknown ::Release du contexte d’affichage pour décrémenter son nombre de références.
Si le nouveau contexte d’affichage n’est pas null, appelez IMAPIViewContext ::SetAdviseSink en utilisant le paramètre pViewContext pour configurer un nouveau récepteur de conseil d’affichage.
Si le nouveau contexte d’affichage n’est pas null, appelez la méthode IMAPIViewContext ::GetViewStatus pour déterminer les indicateurs status qui ont été définis.
Si le nouveau contexte d’affichage n’est pas null, stockez-le et appelez sa méthode IUnknown ::AddRef pour incrémenter son nombre de références.
Mettez à jour tous les éléments de l’interface utilisateur qui dépendent du contexte d’affichage.
En fonction des indicateurs status retournés par IMAPIViewContext ::GetViewStatus, SetViewContext peut également effectuer d’autres actions. Par exemple, si les indicateurs VCSTATUS_NEXT et VCSTATUS_PREV sont retournés, SetViewContext peut activer les boutons Suivant et Précédent pour le nouveau contexte d’affichage.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI utilise la méthode IMAPIForm ::SetViewContext pour définir le contexte d’affichage de MFCMAPI sur le formulaire avant l’affichage du formulaire. |
Voir aussi
IMAPIViewContext::GetViewStatus