rc.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WINDOW (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
 
                   The Resource Compiler WINDOW Statement
 
WINDOW text, id, x, y, width, height, class[,[style][, framectl]]
[ data-definitions ]
[ BEGIN
control-definition
    .
    .
    .
END ]
 
The WINDOW statement creates a window of the specified class. The statement
defines the position and dimensions of the window relative to its parent
window, as well as the window-box style. The WINDOW statement is typically
used in a WINDOWTEMPLATE or FRAME statement.
 
Typically, only one WINDOW statement is used in a FRAME statement. It
defines the client window belonging to the corresponding frame window. The
optional BEGIN and END keywords enclose any CONTROL statements that are
given with the window. CONTROL statements given in this manner represent
child windows belonging to the window created by the WINDOW statement.
 
Field               Description
────────────────────────────────────────────────────────────────────────────
 
text                Specifies the window title if the style specifies a
                    title bar. This field must contain zero or more
                    characters enclosed in double quotation marks. The
                    character values must be in the range 1 through 255. If
                    a double quotation mark is required in the title, you
                    must include the double quotation mark twice.
 
id                  Specifies the window identifier. This value must be an
                    integer in the range 0 through 65,535, or a simple
                    expression that evaluates to a value in that range.
 
x                   Specifies the x-coordinate of the lower-left corner of
                    the window. This value must be an integer in the range 0
                    through 65,535 or an expression consisting of integers
                    and the addition (+) or subtraction (-) operator. The
                    value is in dialog units. The position is relative to
                    the origin of the parent window.
 
y                   Specifies the y-coordinate of the lower-left corner of
                    the window. This value must be an integer in the range 0
                    through 65,535 or an expression consisting of integers
                    and the addition (+) or subtraction (-) operator. The
                    value is in dialog units. The position is relative to
                    the origin of the parent window.
 
width               Specifies the width of the window. This value must be an
                    integer in the range 1 through 65,535 or an expression
                    consisting of integers and the addition (+) or
                    subtraction (-) operator. The value is in ¼-character
                    units.
 
height              Specifies the height of the window. This value must be
                    an integer in the range 1 through 65,535 or an
                    expression consisting of integers and the addition (+)
                    or subtraction (-) operator. The value is in
                    1/8-character units.
 
class               Specifies the window class. This value can be one of the
                    control classes specified in the table, "Control
                    Classes" (Control Classes) or the name of the window
                    class, enclosed in double quotation marks.
 
style               Specifies the window style. For a list of styles, see
                    the topic Control styles.
 
framectl            Specifies the style of the frame controls belonging to
                    the window. For a list of possible styles, see the topic
                    Frame styles. You can use the bitwise OR (|) operator
                    to combine styles.
 
data-definitions    Specifies a CTLDATA and/or PRESPARAMS statement. These
                    statements define control and presentation data for the
                    window. For more information, see the CTLDATA and
                    PRESPARAMS topics.
 
control-definition  Specifies a CONTROL statement or any one of several
                    predefined control statements. These statements define
                    the style, position, and dimensions of controls in the
                    window.
 
Comments
 
The WINDOW statement can actually contain any combination of CONTROL,
DIALOG, and WINDOW statements. Typically, a WINDOW statement contains one or
no such statements.
 
Example
 
This example creates a client window belonging to the frame window. The
client window belongs to the "MyClientClass" window class and has the
standard window identifier FID_CLIENT.
 
WINDOWTEMPLATE 1
BEGIN
    FRAME "My Window", 1, 10, 10, 320, 130, 0, FCF_STANDARD | FCF_VERTSCROLL
    BEGIN
        WINDOW "", FID_CLIENT, 0, 0, 0, 0, "MyClientClass"
    END
END
 
See Also
 
CONTROL, CTLDATA, DIALOG, FRAME, PRESPARAMS, WINDOWTEMPLATE