Ressource DIALOGEX

Article
06/13/2023

Définit une boîte de dialogue. L’instruction définit la position et les dimensions de la boîte de dialogue à l’écran, ainsi que le style de la boîte de dialogue. Il définit également les éléments suivants :

ID d’aide sur la boîte de dialogue elle-même ainsi que sur les contrôles de la boîte de dialogue.
Utilisation de l’instruction EXSTYLE pour la boîte de dialogue elle-même ainsi que sur les contrôles de la boîte de dialogue.
Épaisseur de police et paramètres italiques pour la police à utiliser dans la boîte de dialogue.
Données spécifiques aux contrôles de la boîte de dialogue.
Utilisation des noms de classes système prédéfinis BEDIT, IEDIT et HEDIT .

nameID DIALOGEX x, y, width, height [ , helpID] [optional-statements]  {control-statements}

Paramètres

nameID

Nom unique ou valeur unique d’entier non signé 16 bits qui identifie la boîte de dialogue.

X

Emplacement sur l’écran du côté gauche de la boîte de dialogue, dans unités de boîte de dialogue.

y

Emplacement sur l’écran du haut de la boîte de dialogue, dans les unités de boîte de dialogue.

Largeur

Largeur de la boîte de dialogue, en unités de boîte de dialogue.

Hauteur

Hauteur de la boîte de dialogue, en unités de boîte de dialogue.

helpID

Expression numérique indiquant l’ID utilisé pour identifier la boîte de dialogue pendant WM_HELP traitement.

optional-statements

Options de la boîte de dialogue. Il peut s’agir de zéro ou plusieurs des instructions suivantes.

.	Description
LÉGENDE « text »	Légende de la boîte de dialogue si elle a une barre de titre. Pour plus d’informations, consultez Instruction CAPTION.
CARACTÉRISTIQUESdword	Valeur DWORD définie par l’utilisateur à utiliser par les outils de ressources. Cette valeur n’est pas utilisée par le système. Pour plus d’informations, consultez Instruction CHARACTERISTICS.
Classe CLASS	Entier non signé 16 bits ou chaîne, placé entre guillemets doubles (« ), qui identifie la classe de la boîte de dialogue. Pour plus d’informations, consultez Instruction CLASS.
EXSTYLE= styles étendus	Style de fenêtre étendu de la boîte de dialogue. Pour plus d’informations, consultez Instruction EXSTYLE.
FONTpointize, « typeface », weight, italic, charset	Taille du point et police de la police. Pour le poids, utilisez les valeurs FW_* définies dans WinGDI.h. Pour l’italique, spécifiez TRUE pour utiliser une police italique, false dans le cas contraire. Pour charset, utilisez la valeur définie dans le membre lfCharSet de la structure LOGFONT . Pour obtenir la police définitive d’une boîte de dialogue, une application doit spécifier un jeu de caractères ainsi que d’autres propriétés de police. Pour plus d’informations, consultez Instruction FONT.
Langue,sous-langage	Langue de la boîte de dialogue. Pour plus d’informations, consultez Language Statement.
MENUmenuname	Menu à utiliser. Cette valeur est le nom du menu ou son identificateur entier. Pour plus d’informations, consultez Instruction MENU.
Styles de style	Styles de la boîte de dialogue. Pour plus d’informations, consultez Instruction STYLE.
VERSIONdword	Valeur DWORD définie par l’utilisateur. Cette instruction est destinée à être utilisée par des outils de ressources supplémentaires et n’est pas utilisée par le système. Pour plus d’informations, consultez Instruction VERSION.

control-statements

Le corps de la ressource DIALOGEX est constitué d’un nombre quelconque d’instructions de contrôle. Il existe quatre familles d’instructions de contrôle : générique, statique, button et edit. Pour plus d'informations, consultez la section Notes.

Certains attributs sont également pris en charge pour la compatibilité descendante. Pour plus d’informations, consultez Attributs de ressources communs.

Notes

Les opérations valides qui peuvent être contenues dans l’une des expressions numériques dans les instructions de DIALOGEX sont les suivantes :

Ajouter ('+')
Soustraire ('-')
Moins unaire ('-')
UNaire NOT ('~')
AND ('&')
OR ('|')

Le corps de la ressource est constitué d’instructions de contrôle génériques, statiques, button et edit. Bien que chacune de ces familles d’instructions utilise une syntaxe différente pour définir des caractéristiques spécifiques de ses contrôles, elles partagent toutes une syntaxe commune pour définir la position, la taille, les styles étendus, le numéro d’identification de l’aide et les données spécifiques au contrôle. Pour plus d’informations, consultez Paramètres de contrôle communs.

Instructions de contrôle génériques

CONTROL controlText, id, className, style

controlText: Texte de fenêtre pour le contrôle. Pour plus d’informations, consultez Paramètres de contrôle communs.
Id: Identificateur de contrôle. Pour plus d’informations, consultez Paramètres de contrôle communs.
Classname: Nom de la classe. Il peut s’agir d’une chaîne placée entre guillemets doubles (« ) ou de l’une des classes système prédéfinies suivantes : BUTTON, STATIC, EDIT, LISTBOX, SCROLLBAR ou COMBOBOX.
Style: Les styles de fenêtre ( WS_*, BS_*, SS_*, ES_*, LBS_*, SBS_* et CBS_* explicites définis dans Winuser.H peuvent être utilisés en ajoutant un include au fichier .rc : #include "winuser.h"). Pour plus d’informations, consultez Styles de fenêtre.

Instructions de contrôle statiques

staticClass controlText, id

staticClass: LTEXT, RTEXT ou CTEXT.
controlText: Texte de fenêtre pour le contrôle. Pour plus d’informations, consultez Paramètres de contrôle courants.
Id: Identificateur de contrôle. Pour plus d’informations, consultez Paramètres de contrôle courants.

Instructions de contrôle de bouton

buttonClass controlText, id

buttonClass: AUTO3STATE, AUTOCHECKBOX, AUTORADIOBUTTON, CASE À COCHER, PUSHBOX, PUSHBUTTON, RADIOBUTTON, STATE3 ou USERBUTTON.
controlText: Texte de fenêtre pour le contrôle. Pour plus d’informations, consultez Paramètres de contrôle courants.
Id: Identificateur de contrôle. Pour plus d’informations, consultez Paramètres de contrôle courants.

Modifier les instructions de contrôle

editClass id

editClass: EDITTEXT, BEDIT, HEDIT ou IEDIT.
Id: Identificateur de contrôle. Pour plus d’informations, consultez Paramètres de contrôle courants.

Voir aussi

Utilisation de boîtes de dialogue
ACCÉLÉRATEURS
CARACTÉRISTIQUES
CONTRÔLE
CreateDialog
CréerWindow
Boîte de dialogue
GetDialogBaseUnits
LANGUE
LOGFONT
MENU
RCDATA
STRINGTABLE
VERSION