Propriété canonique PidTagControlFlags
S’applique à : Outlook 2013 | Outlook 2016
Contient un masque de bits d’indicateurs qui régissent le comportement d’un contrôle utilisé dans une boîte de dialogue générée à partir d’une table d’affichage.
| Propriété | Valeur |
|---|---|
| Propriétés associées : |
PR_CONTROL_FLAGS |
| Identificateur : |
0x3F00 |
| Type de données : |
PT_LONG |
| Domaine : |
Table d’affichage MAPI |
Remarques
Un ou plusieurs des indicateurs suivants peuvent être définis pour cette propriété :
DT_ACCEPT_DBCS
Le contrôle peut contenir Double-Byte caractères de jeu de caractères (DBCS). Cet indicateur est utilisé avec les contrôles d’édition. Il autorise les jeux de caractères sur plusieurs octets.
DT_EDITABLE
Le contrôle peut être modifié ; la valeur associée au contrôle peut être modifiée. Lorsque cet indicateur n’est pas défini, le contrôle est en lecture seule. Cette valeur est ignorée dans les contrôles étiquette, zone de groupe, bouton push standard, zone de liste déroulante à valeurs multiples et zone de liste.
DT_MULTILINE
Le contrôle d’édition peut contenir plusieurs lignes. Cela signifie qu’un caractère de retour peut être entré dans le contrôle. Cet indicateur est valide uniquement pour les contrôles de modification.
DT_PASSWORD_EDIT
S’applique aux contrôles de modification. Le contrôle d’édition est traité comme un mot de passe. La valeur est affichée à l’aide d’astérisque au lieu de faire écho aux caractères réels entrés.
DT_REQUIRED
Si le contrôle autorise les modifications (DT_EDITABLE), il doit avoir une valeur avant l’appel de IMAPIProp ::SaveChanges .
DT_SET_IMMEDIATE
Active la définition immédiate d’une valeur ; dès qu’une valeur du contrôle change, MAPI appelle la méthode SetProps pour la propriété associée à ce contrôle. Lorsque cet indicateur n’est pas défini, les valeurs sont définies lorsque la boîte de dialogue est ignorée.
DT_SET_SELECTION
Lorsqu’une sélection est effectuée dans la zone de liste, la colonne d’index de cette zone de liste est définie en tant que propriété. Toujours utilisé avec DT_SET_IMMEDIATE.
Cette propriété est stockée dans le membre ulCtlFlags de la structure DTCTL d’un contrôle. La plupart des indicateurs de contrôle s’appliquent à tous les contrôles qui autorisent l’entrée utilisateur ; quelques-uns s’appliquent uniquement au contrôle d’édition. Les contrôles qui n’autorisent pas l’entrée utilisateur, comme un bouton ou une étiquette, définissent 0 pour leurs indicateurs de contrôle.
La plupart des valeurs d’indicateur sont explicites. Par exemple, quand DT_REQUIRED est défini pour un contrôle, il doit contenir une valeur avant que la boîte de dialogue soit autorisée à être ignorée. Soit le fournisseur de services peut fournir une valeur via son implémentation IMAPIProp , soit l’utilisateur peut en entrer une. DT_EDITABLE indique que la valeur du contrôle peut être modifiée. DT_MULTILINE permet à la valeur d’un contrôle d’édition de s’étendre sur plusieurs lignes.
Certains indicateurs de contrôle ne sont pas si évidents dans leur signification. Lorsqu’un contrôle définit l’indicateur DT_SET_IMMEDIATE, toutes les modifications apportées à sa valeur sont affectées dès que l’utilisateur passe à un nouveau contrôle. MAPI effectue un appel unique à la méthode IMAPIProp ::SetProps de l’interface de propriété pour la propriété du contrôle. Cela diffère du comportement par défaut, qui consiste à reporter l’entrée en vigueur des modifications apportées aux valeurs de contrôle jusqu’à ce que l’utilisateur ait sélectionné le bouton OK ou ignoré la boîte de dialogue. L’indicateur DT_SET_IMMEDIATE est souvent utilisé en combinaison avec les notifications de table d’affichage.
Le tableau suivant répertorie les types de contrôles et toutes les valeurs d’indicateur qui peuvent être définies pour chaque type.
| Contrôle | Valeurs valides pour cette propriété |
|---|---|
| Bouton |
Doit être égal à zéro |
| Case à cocher |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Zone de liste modifiable |
DT_EDITABLE, DT_REQUIRED DT_SET_IMMEDIATE |
| Zone de liste déroulante |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Modifier |
DT_ACCEPT_DBCS, DT_MULTILINE, DT_EDITABLE, DT_PASSWORD_EDIT, DT_REQUIRED, DT_SET_IMMEDIATE |
| Zone de groupe |
Doit être égal à zéro |
| Étiquette |
Doit être égal à zéro |
| Zone de liste |
Doit être égal à zéro |
| Zone de liste déroulante à valeurs multiples |
Doit être égal à zéro |
| Zone de liste à valeurs multiples |
Doit être égal à zéro |
| Page à onglets |
Doit être égal à zéro |
| Case d’option |
Doit être égal à zéro |
Ressources connexes
Fichiers d’en-tête
Mapidefs.h
Fournit des définitions de type de données.
Mapitags.h
Contient des définitions de propriétés répertoriées en tant que noms alternatifs.