Predefined Control Statements

In addition to the general form of the CONTROL statement, there are special control statements for commonly used controls. These statements define the attributes of the child control windows that appear in the window.

Control statements have this general form:

 ─controltype─text─,─id─,─x─,─y─,─cx─,─cy───

 ───┬──────────────────┬────────────
     └──,───style───────┘

            ┌─────────────────────────┐
                                     │
 ───BEGIN────┬──DIALOG statement───┬─┴─END───
              ├──CONTROL statement──┤
              └──WINDOW statement───┘

The following six controls are exceptions to this form because they do not take a text field. See the LISTBOX control statement for the form of these six controls.

• CONTAINER
  
• LISTBOX
  
• NOTEBOOK
  
• SLIDER
  
• SPINBUTTON
  
• VALUESET

controltype

is one of the keywords described below, defining the type of the control.

is a string specifying the text to be displayed. The string must be enclosed in double quotation marks. The manner in which the text is displayed depends on the particular control, as detailed below.

To indicate the mnemonic for each item, insert the tilde character (~) in the string preceding the mnemonic character.

The double quotation marks are required for the COMBOBOX title even if no title is used.

is a unique integer number identifying the control.

are integer numbers specifying the x- and y-coordinates of the lower left corner of the control, in dialog coordinates. The coordinates are relative to the origin of the dialog.

are integer numbers specifying the width and height of the control.

The x, y, cx, and cy fields can use addition and subtraction operators (+ and -). For example, 15 + 6 can be used for the x-field.

Styles can be combined using the (|) operator.

The control type keywords are shown below, with their classes and default styles:

AUTOCHECKBOX

Class

WC_BUTTON
Default style
WS_TABSTOP, WS_VISIBLE, BS_AUTOCHECKBOX
AUTORADIOBUTTON

Class

WC_BUTTON
Default style
BS_AUTORADIOBUTTON, WS_TABSTOP, WS_VISIBLE
CHECKBOX

Class

WC_BUTTON
Default style
BS_CHECKBOX, WS_TABSTOP, WS_VISIBLE
COMBOBOX

Format

The form of the COMBOBOX control statement is shown below.

The fields have the same meaning as in the other control statements.

 ───COMBOBOX──"title"──,──id───,───x───,───y───,───cx─
 ───,───cy──┬─────────────┬──
             └──,───style──┘

Class
WC_COMBOBOX
Default style
CBS_SIMPLE, WS_TABSTOP, WS_VISIBLE
CONTAINER

Format

The CONTAINER control statement does not contain a text field, so it has the same format as the LISTBOX statement.
Class
WC_CONTAINER
Default style
WS_TABSTOP, WS_VISIBLE, CCS_SINGLESEL
CTEXT

Class

WC_STATIC
Default style
SS_TEXT, DT_CENTER, WS_GROUP, WS_VISIBLE
DEFPUSHBUTTON

Class

WC_BUTTON
Default style
BS_DEFAULT, BS_PUSHBUTTON, WS_TABSTOP, WS_VISIBLE
EDITTEXT

Class

WC_ENTRYFIELD
Default style
WS_TABSTOP, WS_VISIBLE, ES_AUTOSCROLL
ENTRYFIELD

Class

WC_ENTRYFIELD
Default style
WS_TABSTOP, ES_LEFT, WS_VISIBLE
FRAME

Class

WC_FRAME
Default style
WS_VISIBLE
GROUPBOX

Class

WC_STATIC
Default style
SS_GROUPBOX, WS_TABSTOP, WS_VISIBLE
ICON

Class

WC_STATIC
Default style
SS_ICON, WS_VISIBLE
LISTBOX

Format

The form of the LISTBOX control statement is different from the general form because it does not take a text field, however the fields have the same meaning as in the other control statements. The form of the LISTBOX control statement is shown below.

 ──controltype───id───,───x───,───y───,───cx──
 ───,───cy──┬─────────────┬──
             └──,───style──┘

Class
WC_LISTBOX
Default style
WS_BORDER, WS_VISIBLE
LTEXT

Class

WC_STATIC
Default style
SS_TEXT, DT_LEFT, WS_GROUP, WS_VISIBLE
MLE

Class

WC_MLE
Default style
WS_TABSTOP, WS_VISIBLE, MLS_BORDER
NOTEBOOK

Format

The NOTEBOOK control statement does not contain a text field, so it has the same format as the LISTBOX statement.
Class
WC_NOTEBOOK
Default style
WS_TABSTOP, WS_VISIBLE
PUSHBUTTON

Class

WC_BUTTON
Default style
BS_PUSHBUTTON, WS_TABSTOP, WS_VISIBLE
RADIOBUTTON

Class

WC_BUTTON
Default style
BS_RADIOBUTTON, WS_TABSTOP, WS_VISIBLE
RTEXT

Class

WC_STATIC
Default style
SS_TEXT, DT_RIGHT, WS_GROUP, WS_VISIBLE
SLIDER

Format

The SLIDER control statement does not contain a text field, so it has the same format as the LISTBOX statement.
Class
WC_SLIDER
Default style
WS_SLIDER, WS_TABSTOP, WS_VISIBLE
SPINBUTTON

Format

The SPINBUTTON control statement does not contain a text field, so it has the same format as the LISTBOX statement.
Class
WC_SPINBUTTON
Default style
WS_TABSTOP, WS_VISIBLE, SPBS_MASTER
VALUESET

Format

The VALUESET control statement does not contain a text field, so it has the same format as the LISTBOX statement.
Class
WC_VALUESET
Default style
WS_TABSTOP, WS_VISIBLE

Examples

The following is a complete example of a DIALOG statement:

DLGTEMPLATE "errmess"
BEGIN
    DIALOG  "Disk Error", 100, 10, 10, 300, 110
    BEGIN
        CTEXT "Select One:", 1, 10, 80, 280, 12
        RADIOBUTTON "Retry", 2, 75, 50, 60, 12
        RADIOBUTTON "Abort", 3, 75, 30, 60, 12
        RADIOBUTTON "Ignore", 4, 75, 10, 60, 12
    END
END

This is an example of a WINDOWTEMPLATE statement that is used to define a specific kind of window frame. Calling Load Dialog with this resource automatically creates the frame window, the frame controls, and the client window (of class MyClientClass).

WINDOWTEMPLATE "wind1"
BEGIN
 FRAME "My Window", 1, 10, 10, 320, 130, WS_VISIBLE,
        FCF_STANDARD | FCF_VERTSCROLL
 BEGIN
  WINDOW "", FID_CLIENT, 0, 0, 0, 0, "MyClientClass",
                                                  style
 END
END

This example creates a resource template for a parallel dialog identified by the constant parallel1. It includes a frame with a title bar, a system menu, and a dialog-style border. The parallel dialog has three auto radio buttons in it.

DLGTEMPLATE parallel1
BEGIN
    DIALOG "Parallel Dialog", 1, 50, 50, 180, 110
    CTLDATA FCF_TITLEBAR | FCF_SYSMENU | FCF_DLGBORDER
    BEGIN
        AUTORADIOBUTTON "Retry", 2, 75, 80, 60, 12
        AUTORADIOBUTTON "Abort", 3, 75, 50, 60, 12
        AUTORADIOBUTTON "Ignore", 4, 75, 30, 60, 12
    END
END

---

[Back: Predefined Window Classes]
[Next: Resource (.RES) File Specification]