Common Control Parameters

  • Article

The following describes the general syntax for a control resource-definition statement, represented by control. Occasionally, a statement uses a parameter differently, or may ignore a parameter. The statement-specific variation is described in the documentation for the statement.

control [[text,]] id, x, y, width, height [[, style [[, extended-style]]]][, helpId]
 [{ data-element-1 [, data-element-2 [, ... ]] }]

Parameters

  • text
    Specifies text that is displayed with the control. The text is positioned within the control's specified dimensions or adjacent to the control.

    This parameter must contain zero or more characters enclosed in double quotation marks ("). Strings are automatically null-terminated and converted to Unicode in the resulting resource file.

    By default, the characters listed between the double quotation marks are ANSI characters, and escape sequences are interpreted as byte escape sequences. If the string is preceded by the L prefix, the string is a wide-character string and escape sequences are interpreted as 2-byte escape sequences that specify Unicode characters. If a double quotation mark is required in the text, you must include the double quotation mark twice.

    An ampersand (&) character in the text indicates that the following character is used as a mnemonic character for the control. When the control is displayed, the ampersand is not shown, but the mnemonic character is underlined. The user can choose the control by pressing the key corresponding to the underlined mnemonic character. To use the ampersand as a character in a string, insert two ampersands (&&).

  • id
    Specifies the control identifier. This value must be a 16-bit unsigned integer in the range 0 through 65,535 or a simple arithmetic expression that evaluates to a value in that range.

  • x
    Specifies the x-coordinate of the left side of the control relative to the left side of the dialog box. This value must be a 16-bit unsigned integer in the range 0 through 65,535. The coordinate is in dialog units and is relative to the origin of the dialog box, window, or control containing the specified control.

  • y
    Specifies the y-coordinate of the top side of the control relative to the top of the dialog box. This value must be a 16-bit unsigned integer in the range 0 through 65,535. The coordinate is in dialog units relative to the origin of the dialog box, window, or control containing the specified control.

  • width
    Specifies the width of the control. This value must be a 16-bit unsigned integer in the range 1 through 65,535. The width is in 1/4-character units.

  • height
    Specifies the height of the control. This value must be a 16-bit unsigned integer in the range 1 through 65,535. The height is in 1/8-character units.

  • style
    Specifies the control styles. Use the bitwise OR (|) operator to combine styles.

  • extended-style
    Specifies extended window styles. You must specify style to specify extended-style. For more information about extended styles, see EXSTYLE.

  • helpID
    Specifies a numeric expression indicating the identifier of the control during WM_HELP processing.

  • controlData
    Specifies the control-specific data for the control. When a dialog box is created, if it contains a control that has control-specific data, a pointer to that data is passed into the control's window procedure by means of the lParam of the WM_CREATE message for that control.

Remarks

Horizontal dialog units are 1/4 of the dialog base width unit. Vertical units are 1/8 of the dialog base height unit. The current dialog base units are computed from the height and width of the current system font. The GetDialogBaseUnits function returns the dialog base units in pixels. The coordinates are relative to the origin of the dialog box.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.