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

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Conceptuel

Boîtes de dialogue

Autres ressources

MultiByteToWideChar

WM_HELP