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

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

création de WM _

Conceptuel

Boîtes de dialogue

Autres ressources

MultiByteToWideChar

_aide WM