DIALOGEX Resource

  • Article

This resource-definition statement is an extension of the DIALOG resource-definition statement that additionally supports the following:

  • Help identifiers on the dialog box itself, as well as on controls within the dialog box.
  • Use of the EXSTYLE statement for the dialog box itself, as well as on controls within the dialog box.
  • Font weight and italic settings for the font to be used in the dialog box.
  • Control-specific data for controls within the dialog box.
  • Use of the BEDIT, IEDIT, and HEDIT predefined system class names.
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, in dialog units, the location on the screen of the left side of the dialog box.

  • y
    Specifies, in dialog units, the location on the screen of the top of the dialog box.

  • width
    Specifies, in dialog units, the width of the dialog box.

  • height
    Specifies, in dialog units, the height of the dialog box.

  • helpID
    Specifies a numeric expression that indicates the identifier of the dialog box during WM_HELP processing.

  • optional-statements
    Specifies options for the dialog box. This can be zero or more of the following statements:

    Value 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 the header file 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. For more information, see MENU.
    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 about these families, see Remarks.

Remarks

The following valid operations can be contained in any of the numeric expressions in the statements of DIALOGEX:

  • 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 position, size, extended styles, Help identification number, and control-specific data.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.