DLGITEMTEMPLATEEX, structure
Bloc de texte utilisé par un modèle de boîte de dialogue étendu pour décrire la boîte de dialogue étendue. Pour obtenir une description du format d’un modèle de boîte de dialogue étendue, consultez DLGTEMPLATEEX.
Syntaxe
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
Membres
-
helpID
-
Type : DWORD
-
Identificateur du contexte d’aide pour le contrôle. Lorsque le système envoie un message _ d’aide WM , il transmet la valeur HelpID dans le membre dwContextId de la structure HELPINFO .
-
exStyle
-
Type : DWORD
-
Styles étendus pour une fenêtre. Ce membre n’est pas utilisé pour créer des contrôles dans les boîtes de dialogue, mais les applications qui utilisent des modèles de boîte de dialogue peuvent l’utiliser pour créer d’autres types de fenêtres. Pour obtenir la liste des valeurs, consultez styles de fenêtre étendus.
-
style
-
Type : DWORD
-
Style du contrôle. Ce membre peut être une combinaison de valeurs de style de fenêtre (par exemple, WS _ Border) et une ou plusieurs des valeurs de style de contrôle (par exemple, BS _ PUSHBUTTON et es restantes). _
-
x
-
Type : short
-
Coordonnée x, en unités de boîte de dialogue, du coin supérieur gauche du contrôle. Cette coordonnée est toujours relative à l’angle supérieur gauche de la zone cliente de la boîte de dialogue.
-
y
-
Type : short
-
Coordonnée y, en unités de boîte de dialogue, de l’angle supérieur gauche du contrôle. Cette coordonnée est toujours relative à l’angle supérieur gauche de la zone cliente de la boîte de dialogue.
-
adéquat
-
Type : short
-
Largeur, en unités de boîte de dialogue, du contrôle.
-
CY
-
Type : short
-
Hauteur, en unités de boîte de dialogue, du contrôle.
-
id
-
Type : DWORD
-
Identificateur du contrôle.
-
windowClass
-
Type : SZ _ ou _ ORD
-
Tableau de longueur variable d’éléments 16 bits qui spécifie la classe de fenêtre du contrôle. Si le premier élément de ce tableau a une valeur autre que 0xFFFF, le système traite le tableau comme une chaîne Unicode terminée par le caractère null qui spécifie le nom d’une classe de fenêtre inscrite.
Si le premier élément est 0xFFFF, le tableau a un élément supplémentaire qui spécifie la valeur ordinale d’une classe système prédéfinie. L’ordinal peut être l’une des valeurs Atom suivantes.
Valeur Signification - 0x0080
Bouton - 0x0081
Modifier - 0x0082
statique - 0x0083
Zone de liste - 0x0084
Scroll bar - 0x0085
Combo box -
title
-
Type : SZ _ ou _ ORD
-
Tableau de longueur variable d’éléments 16 bits qui contient le texte initial ou l’identificateur de ressource du contrôle. Si le premier élément de ce tableau est 0xFFFF, le tableau a un élément supplémentaire qui spécifie la valeur ordinale d’une ressource, telle qu’une icône, dans un fichier exécutable. Vous pouvez utiliser un identificateur de ressource pour les contrôles, tels que les contrôles d’icône statique, qui chargent et affichent une icône ou une autre ressource plutôt que du texte. Si le premier élément est une valeur autre que 0xFFFF, le système traite le tableau comme une chaîne Unicode terminée par le caractère null qui spécifie le texte initial.
-
extraCount
-
Type : Word
-
Nombre d’octets de données de création qui suivent ce membre. Si cette valeur est supérieure à zéro, les données de création commencent à la limite de mot suivante. Ces données de création peuvent avoir n’importe quelle taille et n’importe quel format. La procédure de fenêtre du contrôle doit être en mesure d’interpréter les données. Lorsque le système crée le contrôle, il passe un pointeur vers ces données dans le paramètre lParam du message WM _ Create qu’il envoie au contrôle.
Notes
Un modèle étendu pour une boîte de dialogue se compose d’un en-tête DLGTEMPLATEEX suivi d’une structure DLGITEMTEMPLATEEX pour chaque contrôle dans la boîte de dialogue.
Chaque structure DLGITEMTEMPLATEEX doit être alignée sur une limite DWORD . Les tableaux de WindowClass de longueur variable et de titre doivent être alignés sur les limites de mots . Le tableau de données de création, le cas échéant, doit être aligné sur une limite de mot .
Si vous spécifiez des chaînes de caractères dans les tableaux WindowClass et title , vous devez utiliser des chaînes Unicode. Utilisez la fonction MultiByteToWideChar pour générer des chaînes Unicode à partir de chaînes ANSI.
Les membres x, y, CX et CY spécifient des valeurs dans les unités de la boîte de dialogue. Vous pouvez convertir ces valeurs en unités d’écran (pixels) à l’aide de la fonction MapDialogRect .
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel - [Applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
Voir aussi
-
Référence
-
Conceptuel
-
Autres ressources