Implémentation de la table d’affichage
S’applique à : Outlook 2013 | Outlook 2016
Une table d’affichage permet d’afficher une feuille de propriétés, une boîte de dialogue spéciale composée d’une ou plusieurs pages de propriétés à onglets dédiées à l’affichage et éventuellement à la modification d’une ou plusieurs propriétés. Une implémentation de l’interface IAttach : IMAPIProp est associée à chaque table d’affichage. L’implémentation IMAPIProp conserve les données de propriété qui sont présentées dans la feuille de propriétés.
Les lignes d’une table d’affichage représentent les contrôles de la feuille de propriétés. La plupart des contrôles peuvent être associés aux propriétés gérées avec l’implémentation IMAPIProp . Lorsqu’un utilisateur modifie la valeur d’un contrôle modifiable, la propriété correspondante est mise à jour.
Les colonnes d’une table d’affichage représentent les propriétés du contrôle, telles que sa position dans la feuille de propriétés, son type, la structure associée et l’identificateur. Pour obtenir la liste complète des colonnes de table d’affichage requises, consultez Afficher les tables.
MAPI affiche une feuille de propriétés à l’utilisateur d’une application cliente en lisant les valeurs des propriétés à partir de l’implémentation IMAPIProp associée à la table d’affichage ou directement à partir de la table d’affichage. Lorsque l’utilisateur travaille avec la feuille de propriétés, en modifiant les valeurs dans les contrôles, MAPI appelle IMAPIProp ::SetProps pour enregistrer un contrôle modifié si l’indicateur DT_SET_IMMEDIATE du contrôle est défini. Pour les contrôles sans indicateur de DT_SET_IMMEDIATE, les modifications apportées aux propriétés sont enregistrées lorsque l’utilisateur ferme la boîte de dialogue en cliquant sur le bouton OK ou Appliquer maintenant . Lorsque l’un de ces boutons ou le bouton Annuler est cliqué, MAPI supprime la feuille de propriétés de la vue.
MAPI obtient l’accès à votre table d’affichage en appelant la méthode IMAPIProp ::OpenProperty dans l’implémentation IMAPIProp et en demandant la propriété PR_DETAILS_TABLE (PidTagDetailsTable) ou en l’héritant dans un appel que vous avez effectué à MAPI, tel que IMAPISupport ::D oConfigPropsheet.
La première technique d’accès est utilisée lorsque les fournisseurs de carnets d’adresses sont invités à afficher des détails sur les utilisateurs de messagerie ou les listes de distribution. Le traitement suivant se produit :
Un client appelle la méthode IAddrBook ::D etails .
MAPI appelle la méthode IABLogon ::OpenEntry du fournisseur de carnet d’adresses pour accéder à l’utilisateur de messagerie qui représente l’entrée sélectionnée.
MAPI appelle la méthode IMAPIProp ::OpenProperty de l’utilisateur de messagerie pour récupérer la propriété PR_DETAILS_TABLE , la table d’affichage de la boîte de dialogue détails.
MAPI affiche la boîte de dialogue, gère l’interaction de l’utilisateur avec les informations et la supprime lorsque l’utilisateur a terminé.