DTBLCOMBOBOX

S’applique à : Outlook 2013 | Outlook 2016

Décrit un contrôle de zone de liste modifiable 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
Macro associée : SizedDtblComboBox

typedef struct _DTBLCOMBOBOX
{
  ULONG ulbLpszCharsAllowed;
  ULONG ulFlags;
  ULONG ulNumCharsAllowed;
  ULONG ulPRPropertyName;
  ULONG ulPRTableName;
} DTBLCOMBOBOX, FAR *LPDTBLCOMBOBOX;

Members

ulbLpszCharsAllowed

Décalage du début de la structure DTBLCOMBOBOX vers un filtre de chaîne de caractères qui décrit les restrictions, le cas échéant, sur les caractères qui peuvent être entrés dans le contrôle d’édition de la zone de liste déroulante. Le filtre n’est pas interprété comme une expression régulière et le même filtre est appliqué à chaque caractère entré. Le format du filtre est le suivant :

Caractère	Description
*	Tout caractère est autorisé (par exemple, "*").
[ ]	Définit un ensemble de caractères (par exemple, "[0123456789]").
-	Indique une plage de caractères (par exemple, "[a-z]").
~	Indique que ces caractères ne sont pas autorisés. (par exemple : "[~0-9]").
\	Utilisé pour citer l’un des symboles précédents (par exemple, "[\-\\\[\]]" signifie -, , caractères [, et ] sont autorisés).

ulFlags

Masque de bits des indicateurs utilisés pour désigner le format du filtre de chaîne de caractères. L’indicateur suivant peut être défini :

MAPI_UNICODE

Le filtre est au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, le filtre est au format ANSI.

ulNumCharsAllowed

Nombre maximal de caractères pouvant être entrés dans la zone de texte de la zone de liste déroulante.

ulPRPropertyName

Balise de propriété pour une propriété de type PT_TSTRING.

ulPRTableName

Balise de propriété pour une propriété de type PT_OBJECT sur laquelle une interface IMAPITable peut être ouverte à l’aide d’un appel OpenProperty . La table doit avoir une colonne avec une propriété du même type que la propriété identifiée par le membre ulPRPropertyName . Les lignes de la table sont utilisées pour remplir la liste.

Remarques

Une structure DTBLCOMBOBOX décrit une zone de liste modifiable un contrôle qui se compose d’une liste et d’un champ de sélection. La liste présente les informations à partir desquelles un utilisateur peut sélectionner, et le champ de sélection affiche la sélection actuelle. Le champ de sélection est un contrôle d’édition qui peut également être utilisé pour entrer du texte qui ne figure pas déjà dans la liste.

Les deux membres de balise de propriété fonctionnent ensemble pour coordonner l’affichage de la liste avec le contrôle d’édition. Lorsque MAPI affiche pour la première fois la zone de liste déroulante, il appelle la méthode OpenProperty de l’implémentation IMAPIProp associée à la table d’affichage pour récupérer la table représentée par le membre ulPRTableName . Cette table comporte une colonne qui contient les valeurs de la propriété représentée par le membre ulPRPropertyName . Par conséquent, cette colonne doit être du même type que la propriété ulPRPropertyName et les deux colonnes doivent être des chaînes de caractères.

Les valeurs de la colonne sont affichées dans la section liste de la zone de liste déroulante. Par conséquent, PR_NULL (PidTagNull) n’est pas une balise de propriété valide pour ulPRPropertyName. Lorsqu’un utilisateur sélectionne l’une des lignes ou entre de nouvelles données dans la zone de texte, la propriété ulPRPropertyName est définie sur la valeur sélectionnée ou entrée.

Pour afficher une valeur initiale pour le contrôle d’édition, MAPI appelle IMAPIProp ::GetProps pour récupérer les valeurs de propriété de la table d’affichage. Si l’une des propriétés récupérées correspond à la propriété représentée par le membre ulPRPropertyName , sa valeur devient la valeur initiale.

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.

Voir aussi

DTCTL
Structures MAPI de propriété canonique PidTagControlType