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:

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:

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