Dialog and Window Template Statements

This section describes how to define dialog and window templates.

It also describes the control data and presentation parameter structures that the application needs to create windows and define dialog templates.

DLGTEMPLATE and WINDOWTEMPLATE statements are used by an application to create predefined window and dialog resource templates. These statements are treated identically by the resource compiler and have the following format:

 ───┬─DLGTEMPLATE─────┬──resourceid─────────
      └─WINDOWTEMPLATE──┘

 ────┬───────────┬┬───────────┬┬──────────┬──
      └loadoption─┘└─memoption─┘└─codepage─┘

 ───BEGIN──┬──DIALOG statement───┬───END───
            ├──CONTROL statement──┤
            └──WINDOW statement───┘

In the following description of the parts of the DLGTEMPLATE and WINDOWTEMPLATE statements, data types are shown after each parameter or option. These are the data types that the parameter or option is converted to when it is compiled.

Purpose

The DLGTEMPLATE or WINDOWTEMPLATE statement marks the beginning of a window template. It defines the name of the window, and its memory and load options.
resourceid (USHORT)
This is either:

• An integer (or a name that resolves to an integer) in the range of 1 through 65535

• A unique string enclosed in double quote marks
loadoption (LOADOPTION)
The default is LOADONCALL.

See Resource Load and Memory Options for a description of LOADOPTION.

memoption (MEMOPTION)
The default is MOVEABLE.

See Resource Load and Memory Options for a description of MEMOPTION.

code page (USHORT)
The code page of the text in the template.

Alternatively, ({) can be used in place of BEGIN and (}) in place of END.

The DLGTEMPLATE and WINDOWTEMPLATE keywords are synonymous.

The DIALOG statement defines a dialog-box window that can be created by an application and has the following format:

 ───DIALOG───text─,─id─,─x─,─y─,─cx─,─cy────
 ───────┬───────────────────┬────────────────
         └─,style─┬──────────┤
                  └─,control─┘

 ──────────────────┬┬───────────────────────┬
  │                 ││┌─────────────────────┐│
  │                 ││                     ││
  └CTLDATA─statement┘└─PRESPARAMS─statement─┴┘

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

Control Data Statement
Presentation Parameters Statement

The WINDOW and CONTROL statements have the format:

 ─┬─WINDOW─┬─text,─id,─x,─y,─cx,─cy,─class──    └─CONTROL┘

 ──┬──────────────────────────┬────
    └───,style───┬─────────────┤
                 └──,control───┘


 ──────────────────┬┬───────────────────────┬
  │                 ││┌─────────────────────┐│
  │                 ││                     ││
  └CTLDATA─statement┘└─PRESPARAMS─statement─┴┘

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

Control Data Statement
Presentation Parameters Statement

Note: The WINDOW and CONTROL keywords are synonymous.

The DIALOG, CONTROL, and WINDOW statements between the BEGIN and END statements are defined as child windows. Presentation parameters always apply to the whole control. They cannot be changed for the individual items within the control.

Following is the description of the parameters for these statements.

Purpose

These statements mark the beginning of a window. They define the starting location on the display screen, its width, its height, and other details such as style.

Note: Not all values may be specified for each statement type. For details, see the call syntax diagrams.

text (PCH)
A string, enclosed in double quotes, that is displayed in the title-bar control, if it exists. To insert a double-quote character (") in the text, use two double-quote characters ("").
id (USHORT)
Item identifier.
x,y (SHORT)
Integer numbers specifying the x- and y-coordinates on the display screen of the lower left corner of the dialog. X and y are in dialog coordinates. The exact meaning of the coordinates depends on the style defined by the style argument. For normal dialogs, the coordinates are relative to the origin of the parent window. For FCF_SCREENALIGN style boxes, the coordinates are relative to the origin of the display screen. With FCF_MOUSEALIGN, the coordinates are relative to the position of the pointer at the time the dialog is created.
cx,cy (SHORT)
Integer numbers specifying the width and height of the window.
class (PCH)
The class of the window or control to be created.

Note: For a DIALOG statement the class is fixed as WC_FRAME and cannot be specified.

style (ULONG)
Any additional window style, frame style, or other class-specific style.

The default style is WS_SYNCPAINT | WS_CLIPSIBLINGS | WS_SAVEBITS | FS_DLGBORDER. If the FS_DLGBORDER or WS_SAVEBITS styles are not required, they should be preceded by the keyword "NOT". For example:

NOT FS_DLGBORDER | FS_BORDER | NOT WS_SAVEBITS

replaces the FS_DLGBORDER default style by the FS_BORDER style and removes the WS_SAVEBITS style. Note that the logic of the NOT keyword is different from the corresponding operator in the C language.

It is not possible to remove the default WS_SYNCPAINT and WS_CLIPSIBLINGS styles.

control (ULONG)
Frame Creation Flags (FCF_*) for the window.

This data is placed in the control data field in the correct format for a window of class WC_FRAME.

Note: FCF_SHELLPOSITION has no effect if specified in a template.

CTLDATA Statement
A statement used to define control data for the control. For more information on this statement, see Control Data Statement
PRESPARAMS Statement
A statement used to define presentation parameters. For more information on this statement, see Presentation Parameters Statement

---

[Back: ASSOCTABLE Statement]
[Next: MENU Statement]