Partager via


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

IMAPIViewContext::SetAdviseSink

IMAPIForm : IUnknown

MFCMAPI comme un exemple de Code