rc.hlp (Table of Contents; Topic list)
WINDOWTEMPLATE (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
 
               The Resource Compiler WINDOWTEMPLATE Statement
 
WINDOWTEMPLATE window-id [load-option] [mem-option]
BEGIN
window-definition
    .
    .
    .
END
 
The WINDOWTEMPLATE statement creates a window template. A window template
consists of a series of statements that define the window identifier, load
and memory options, window dimensions, and controls in the window. The
window template can be loaded from the executable file by using the
WinLoadDlg function.
 
You can provide any number of window templates in a resource-definition
file, but each template must have a unique window-id value.
 
Field              Description
────────────────────────────────────────────────────────────────────────────
 
window-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.
 
load-option        Specifies when the system loads the resource from the
                   executable file into memory. This value must be one of
                   the following:
 
                   Value       Meaning
                   ─────────────────────────────────────────────────────────
                   PRELOAD     System loads the resource when the
                               application starts.
 
                   LOADONCALL  System loads the resource when the
                               application calls the WinLoadDlg function.
                               This is the default value.
 
mem-option         Specifies how the system manages the resource when it is
                   in memory. This value must be one or more of the
                   following:
 
                   Value        Meaning
                   ─────────────────────────────────────────────────────────
                   FIXED        System keeps the resource at a fixed memory
                                location.
 
                   MOVEABLE     System moves the resource as necessary to
                                compact memory.
 
                   DISCARDABLE  System discards the resource if it is no
                                longer needed.
 
                   The default setting is MOVEABLE and DISCARDABLE.
 
window-definition  Specifies a WINDOW statement. The statement defines the
                   dimensions and style of the given window. For details
                   about the statement, see the WINDOW topic.
 
Comments
 
A WINDOWTEMPLATE statement can contain DIALOG, CONTROL, and WINDOW
statements. Typically, only one WINDOW statement is used in the
WINDOWTEMPLATE statement.
 
See Also
 
CONTROL, DIALOG, WINDOW