DTBLDDLBX
S’applique à : Outlook 2013 | Outlook 2016
Décrit un contrôle de liste déroulante qui sera utilisé dans une boîte de dialogue générée à partir d’une table d’affichage.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
Members
ulFlags
Réservé, doit être égal à zéro.
ulPRDisplayProperty
Balise de propriété pour une propriété de type PT_TSTRING. Cette propriété est l’une des colonnes de la table identifiée par le membre ulPRTableName . Les valeurs de cette propriété sont affichées dans la liste.
ulPRSetProperty
Balise de propriété pour une propriété de n’importe quel type. Cette propriété est l’une des colonnes de la table identifiée par le membre ulPRTableName . Lorsque l’utilisateur de la liste sélectionne une valeur de propriété pour le membre ulPRDisplayProperty à partir des lignes de la table identifiée par le membre ulPRTableName , le membre ulPRSetProperty correspondant est défini.
ulPRTableName
Balise de propriété pour une propriété de table de type PT_OBJECT qui peut être ouverte à l’aide d’un appel OpenProperty . La table doit comporter deux colonnes : ulPRDisplayProperty et ulPRSetProperty. Les lignes de la table doivent correspondre aux éléments de la liste.
Remarques
Une structure DTBLDDLBX décrit un contrôle de liste déroulante qui s’affiche en tant qu’élément unique jusqu’à ce que l’utilisateur choisisse de le développer.
Les trois propriétés identifiées par les balises de propriété fonctionnent ensemble pour afficher les informations dans la liste et définir une propriété associée. Le membre ulPRTableName est un objet de table accessible via un appel à IMAPIProp ::OpenProperty. La table comporte deux colonnes : une colonne pour la propriété identifiée par le membre ulPRDisplayProperty et l’autre pour la propriété identifiée par le membre ulPRSetProperty .
La propriété ulPRDisplayProperty pilote l’affichage de liste. Lorsqu’un utilisateur sélectionne l’une des valeurs de l’affichage, MAPI appelle IMAPIProp ::SetProps pour définir la propriété correspondante comme identifié par le membre ulPRSetProperty . Cela signifie que la propriété dans la même ligne que la propriété d’affichage sélectionnée. Le membre ulPRSetProperty ne peut pas être défini sur PR_NULL (PidTagNull).
Une valeur initiale s’affiche dans la liste si MAPI a récupéré la propriété représentée par le membre ulPRSetProperty via un appel à IMAPIProp ::GetProps et a localisé une ligne dans la table avec la valeur du membre ulPRSetProperty . La valeur initiale affichée est le contenu de la colonne ulPRDisplayProperty de cette ligne qui correspond à la propriété dans le membre ulPRDisplayProperty de la structure. La valeur retournée par GetProps pour la propriété identifiée par le membre ulPRDisplayProperty devient la valeur initiale affichée lors de la première affichage de la liste.
Pour obtenir une vue d’ensemble des tables d’affichage, consultez Afficher les tables. Pour plus d’informations sur l’implémentation d’une table d’affichage, consultez Implémentation d’une table d’affichage. Pour plus d’informations sur les types de propriétés, consultez Vue d’ensemble des types de propriétés MAPI.