GROUPBOX Statement

Summary: Syntax

GROUPBOX text, id, x, y, width, height[[,style]]

This statement defines a group box belonging to the BUTTON class. It creates a rectangle that groups other controls together. The controls are grouped by drawing a border around them and displaying the given text in the upper-left corner.

The text field takes an ASCII string that specifies the text to be displayed. The string must be enclosed in double quotation marks. To add a mnemonic to the text string, place an ampersand (&) ahead of the letter that will be the mnemonic. Selecting the mnemonic moves the input focus to the next control in the group, in the order set in the resource file. To use an ampersand as a character in a string, insert two ampersands (&&).

The id field takes a unique integer value that identifies the control.

The x and y fields take integer values that specify the x and y coordinates of the upper-left corner of the control. The horizontal units are 1/4 of the dialog base width unit; the 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.

The width and height fields take integer values that specify the width and height of the control. The width units are 1/4 of the dialog base width unit; the height units are 1/8 of the dialog base height unit.

The optional style field can contain any combination (or none) of the following styles:

WS_TABSTOP

WS_DISABLED

These styles are described in the list of window styles following the description of the STYLE statement on page 171.

In addition to these styles, the style field may contain any combination (or none) of the BUTTON-class styles described in the list of control styles on page 190. Styles can be combined using the bitwise inclusive OR operator.

Summary: Comments

The x, y, width, and height fields can use the addition operator (+) for relative positioning. For example, 15 + 6 can be used for the x field.

The default style for GROUPBOX is BS_GROUPBOX and WS_TABSTOP.

The following example demonstrates the correct usage of the GROUPBOX statement:

GROUPBOX “Output”, 42, 10, 10, 30, 50