DIALOGEX Resource
The DIALOGEX resource-definition statement is an extension of the DIALOG resource-definition statement. In addition to the functionality offered by DIALOG, DIALOGEX allows for the following:
-
Help IDs on the dialog itself as well as on controls within the dialog.
-
Use of the EXSTYLE statement for the dialog itself as well as on controls within the dialog.
-
Font weight and italic settings for the font to be used in the dialog.
-
Control-specific data for controls within the dialog.
-
Use of the BEDIT, IEDIT, and HEDIT predefined system class names.
Syntax
nameID DIALOGEX x, y, width, height [ , helpID]] [[ optional-statements]] { control-statements }
Parameters
-
nameID
-
Identifies the dialog box. This is either a unique name or a unique 16-bit unsigned integer value in the range 1 to 65,535.
-
x
-
Specifies the location on the screen of the left side of the dialog, in dialog units.
-
y
-
Specifies the location on the screen of the top of the dialog, in dialog units.
-
width
-
Specifies the width of the dialog, in dialog units.
-
height
-
Specifies the height of the dialog, in dialog units.
-
helpID
-
Specifies a numeric expression indicating the ID used to identify the dialog during WM_HELP processing.
-
optional-statements
-
Specifies options for the dialog box. This can be zero or more of the following statements:
Statement |
Description |
CAPTION "text" |
Specifies the caption of the dialog box if it has a title bar. For more information, see CAPTION. |
CHARACTERISTICS
dword |
Specifies a user-defined DWORD value for use by resource tools. This value is not used by the system. For more information, see CHARACTERISTICS. |
CLASS class |
Specifies a 16-bit unsigned integer or a string, enclosed in double quotation marks ("), that identifies the class of the dialog box. For more information, see CLASS. |
EXSTYLE=extended-styles |
Specifies the extended window style of the dialog box. For more information, see EXSTYLE. |
FONT pointsize, typeface,
weight, italic |
Specifies the point size and typeface for the font. For weight, use the FW_* values defined in WINGDI.H. For italic, specify TRUE to use an italic font, FALSE otherwise. For more information, see FONT. |
LANGUAGE
language,sublanguage |
Specifies the language of the dialog box. For more information, see LANGUAGE. |
MENU menuname |
Specifies the menu to use. This value is either the name of the menu or its integer identifier. |
STYLE styles |
Specifies the styles of the dialog box. For more information, see STYLE. |
VERSION dword |
Specifies a user-defined DWORD value. This statement is intended for use by additional resource tools and is not used by the system. For more information, see VERSION. |
-
control-statements
-
The body of the DIALOGEX resource is made up of any number of control statements. There are four families of control statements: generic, static, button, and edit. For more information, see Remarks.
Remarks
The valid operations that may be contained in any of the numeric expressions in the statements of DIALOGEX are as follows:
-
Add ('+')
-
Subtract ('-')
-
Unary minus ('-')
-
Unary NOT ('~')
-
AND ('&')
-
OR ('|')
The body of the resource is made up of generic, static, button, and edit control statements. While each of these families of statements uses a different syntax for defining specific features of its controls, they all share a common syntax for defining the position, size, extended styles, help identification number, and control-specific data. For more information, see Common Control Parameters.
Generic Control Statements
CONTROL controlText, id, className, style
-
controlText
-
Specifies the window text for the control. For more information, see Common Control Parameters.
-
id
-
Specifies the control identifier. For more information, see Common Control Parameters.
-
className
-
Specifies the name of the class. This may be either a string enclosed in double quotation marks (") or one of the following predefined system classes: BUTTON, STATIC, EDIT, LISTBOX, SCROLLBAR, or COMBOBOX.
-
style
-
Specifies the window styles (explicit WS_*, BS_*, SS_*, ES_*, LBS_*, SBS_*, and CBS_* style values defined in WINUSER.H can be used by adding an include to the RC file: #include "winuser.h")
Static Control Statements
staticClass controlText, id
-
staticClass
-
Specify LTEXT, RTEXT, or CTEXT.
-
controlText
-
Specifies the window text for the control. For more information, see Common Control Parameters.
-
id
-
Specifies the control identifier. For more information, see Common Control Parameters.
Button Control Statements
buttonClass controlText, id
-
buttonClass
-
Specify AUTO3STATE, AUTOCHECKBOX, AUTORADIOBUTTON, CHECKBOX, PUSHBOX, PUSHBUTTON, RADIOBUTTON, STATE3, or USERBUTTON.
-
controlText
-
Specifies the window text for the control. For more information, see Common Control Parameters.
-
id
-
Specifies the control identifier. For more information, see Common Control Parameters.
Edit Control Statements
editClass id
-
editClass
-
Specify EDITTEXT, BEDIT, HEDIT, or IEDIT.
-
id
-
Specifies the control identifier. For more information, see Common Control Parameters.
See Also
CONTROL, CreateDialog, CreateWindow, DialogBox, DIALOGEX, GetDialogBaseUnits, ACCELERATORS, CHARACTERISTICS, LANGUAGE, MENU, RCDATA, STRINGTABLE, VERSION