DTBLCHECKBOX
S’applique à : Outlook 2013 | Outlook 2016
Contient des informations sur une boîte de case activée 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 |
| Macro associée : |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
Members
ulbLpszLabel
Position en mémoire de la chaîne de caractères affichée avec la zone case activée.
ulFlags
Masque de bits des indicateurs utilisés pour désigner le format de l’étiquette de zone de case activée. L’indicateur suivant peut être défini :
MAPI_UNICODE
L’étiquette est au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, l’étiquette est au format ANSI.
ulPRPropertyName
Balise de propriété pour une propriété de type PT_BOOLEAN. La valeur de cette propriété est affectée par l’état de la zone case activée.
Remarques
Une structure DTBLCHECKBOX décrit une zone de case activée un contrôle qui reflète l’un des deux états suivants : activé (case à cocher) ou désactivé (zone vide).
Le membre ulPRPropertyName décrit une propriété booléenne dont la valeur est manipulée en modifiant l’état de la zone case activée. Lorsque la zone case activée est affichée pour la première fois, MAPI appelle la méthode GetProps de l’implémentation IMAPIProp associée à la table d’affichage pour récupérer un ensemble de propriétés par défaut. Si l’une des propriétés est mappée à la balise de propriété dans la structure DTBLCHECKBOX, la valeur de cette propriété est affichée en tant que valeur initiale de la zone de case activée.
Les contrôles de case à cocher peuvent être modifiables. Cela permet à un utilisateur de modifier ses états. Les zones de case activée modifiables définissent l’indicateur DT_EDITABLE dans le membre ulCtlFlags de leur structure DTCTL et dans leur propriété PR_CONTROL_FLAGS (PidTagControlFlags). Lorsqu’une zone de case activée change d’état, MAPI appelle IMAPIProp ::SetProps pour définir la propriété identifiée dans le membre de balise de propriété de la structure DTBLCHECKBOX sur le nouvel état.
Par exemple, un fournisseur de carnet d’adresses peut inclure un contrôle de zone de case activée modifiable dans sa boîte de dialogue de configuration pour ajuster le paramètre de la propriété PR_SEND_RICH_INFO (PidTagSendRichInfo) d’un destinataire. Lorsque l’utilisateur sélectionne la zone case activée, MAPI définit cette propriété sur TRUE. Lorsque la zone case activée n’est pas sélectionnée, la propriété a la valeur FALSE.
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.