DTBLLBX
S’applique à : Outlook 2013 | Outlook 2016
Décrit une liste qui sera utilisée 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 _DTBLLBX
{
ULONG ulFlags;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX
Members
ulFlags
Masque de bits des indicateurs utilisés pour éliminer une barre de défilement horizontale ou verticale de la liste. Les indicateurs suivants peuvent être définis :
MAPI_NO_HBAR
Aucune barre de défilement horizontale ne doit être affichée avec la liste.
MAPI_NO_VBAR
Aucune barre de défilement verticale ne doit être affichée avec 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 ulPRTableTable .
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 . Le nombre de colonnes que la table doit contenir varie selon qu’il s’agit d’une liste de sélection unique ou multiple. Si le membre ulPRSetProperty est défini sur PR_NULL (PidTagNull), la liste autorise la sélection multiple.
Remarques
Une structure DTBLLBX décrit une liste un contrôle utilisé pour afficher plusieurs éléments et permettre à un utilisateur de sélectionner un ou plusieurs éléments.
Le membre ulPRSetProperty et le membre ulPRTableName fonctionnent ensemble ; lorsqu’une valeur est choisie dans la table, elle est réécrite dans ulPRSetProperty lorsque la boîte de dialogue est ignorée.
La valeur des indicateurs indique si une barre de défilement horizontale ou verticale doit être affichée avec la liste. La valeur par défaut est que les types de barres de défilement s’affichent si nécessaire. Les fournisseurs de services peuvent définir MAPI_NO_HBAR pour supprimer une barre de défilement horizontale et MAPI_NO_VBAR pour supprimer une barre de défilement verticale.
Les deux membres de balise de propriété fonctionnent ensemble pour afficher les valeurs dans la liste et définir les propriétés correspondantes lorsqu’un élément de la liste est sélectionné. Lorsque MAPI affiche la liste pour la première fois, il appelle la méthode OpenProperty de l’implémentation IMAPIProp pour récupérer la table identifiée dans le membre ulPRTableName. Le nombre de colonnes dans la table dépend de la valeur du membre ulPRSetProperty . Si ulPRSetProperty est défini sur PR_NULL, la liste est une liste à sélection multiple basée sur un objet qui contient des destinataires, comme un conteneur de carnet d’adresses, une table de destinataires pour un message ou une table de contenu de liste de distribution.
Une table pour une liste de sélections multiples doit inclure les colonnes suivantes :
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_INSTANCE_KEY (PidTagInstanceKey)
PR_DISPLAY_TYPE (PidTagDisplayType) et un maximum de cinq autres propriétés de chaîne à valeurs multiples peuvent également être affichées avec les trois colonnes requises.
Si le membre ulPRSetProperty n’est pas défini sur PR_NULL, la liste est une liste de sélection unique. La valeur initiale de ulPRSetProperty détermine la première ligne sélectionnée. Lorsqu’un utilisateur sélectionne l’une des lignes, le membre ulPRSetProperty est défini sur la valeur sélectionnée et cette valeur est réécrite dans l’implémentation de l’interface de propriété avec un appel à IMAPIProp ::SetProps.
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.