IMAPIFormAdviseSink::OnChange
S’applique à : Outlook 2013 | Outlook 2016
Indique qu’une modification s’est produite dans le status de la visionneuse de formulaires.
HRESULT OnChange(
ULONG ulDir
);
Paramètres
ulDir
[in] Masque de bits d’indicateurs qui fournit des informations sur la modification qui s’est produite dans la visionneuse et la réponse attendue dans le formulaire. 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_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 doit être modal pour la visionneuse de formulaires.
VCSTATUS_NEXT
Il y a un message suivant dans la visionneuse de formulaires.
VCSTATUS_PREV
Il existe un message précédent dans la visionneuse de formulaires.
VCSTATUS_READONLY
Les opérations de suppression, d’envoi et de déplacement doivent être désactivées.
VCSTATUS_UNREAD
Il y a un message non lu suivant ou précédent dans la visionneuse de formulaire.
Valeur renvoyée
S_OK
La notification a réussi.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormAdviseSink ::OnChange pour informer le formulaire d’une modification dans la status d’une visionneuse. En règle générale, la seule modification consiste à définir ou à effacer l’indicateur VCSTATUS_NEXT ou VCSTATUS_PREVIOUS en fonction de la présence ou de l’absence d’un message suivant ou précédent dans la visionneuse. Par conséquent, l’objet formulaire active ou désactive toutes les actions suivantes ou précédentes qu’il prend en charge.
Les paramètres de VCSTATUS_MODAL et VCSTATUS_INTERACTIVE ne peuvent pas changer dans un contexte d’affichage une fois qu’il a été créé.
Remarques pour les responsables de l’implémentation
L’implémentation spécifique de cette méthode dépend entièrement des spécificités du formulaire. La plupart des objets de formulaire utilisent cette méthode pour modifier leur interface utilisateur (par exemple, pour activer ou désactiver des commandes de menu ou des boutons correspondant à la visionneuse status paramètre flags).