Structure DLGITEMTEMPLATEEX
Bloc de texte utilisé par un modèle de boîte de dialogue étendue 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 de contexte d’aide pour le contrôle. Lorsque le système envoie un message WM_HELP , 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 des 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 (telles que WS_BORDER) et d’une ou plusieurs valeurs de style de contrôle (telles que BS_PUSHBUTTON et ES_LEFT).
-
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, 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.
-
Cx
-
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 de contrôle.
-
windowClass
-
Type : sz_Or_Ord
-
Tableau de longueur variable d’éléments 16 bits qui spécifie la classe window du contrôle. Si le premier élément de ce tableau est une valeur autre que 0xFFFF, le système traite le tableau comme une chaîne Unicode terminée par 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 d’atome suivantes.
Valeur Signification - 0x0080
Bouton - 0x0081
Modifier - 0x0082
statique - 0x0083
Zone de liste - 0x0084
Scroll bar - 0x0085
Combo box -
title
-
Type : sz_Or_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 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 WORD suivante. Ces données de création peuvent être de n’importe quelle taille et 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 de la boîte de dialogue.
Chaque structure DLGITEMTEMPLATEEX doit être alignée sur une limite DWORD . Les tableaux windowClass et title de longueur variable doivent être alignés sur les limites de WORD . Le tableau de données de création, le cas échéant, doit être aligné sur une limite WORD .
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 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