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.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
 
                   The Resource Compiler BITMAP Statement
 
BITMAP bitmap-id [load-option] [mem-option] filename
 
The BITMAP statement defines a bitmap resource for an application. A bitmap
resource, typically created using Microsoft Operating System/2 Icon Editor,
is a custom bitmap that an application uses in its display or as an item in
a menu. The BITMAP statement copies the bitmap resource from the file
specified in the filename field and adds it to the application's other
resources. A bitmap resource can be loaded from the executable file when
needed by using the GpiLoadBitmap function.
 
You can provide any number of BITMAP statements in a resource-definition
file, but each statement must specify a unique bitmap-id value.
 
Field        Description
────────────────────────────────────────────────────────────────────────────
 
bitmap-id    Specifies the bitmap-resource 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 GpiLoadBitmap 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 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. This is the default value.
 
             DISCARDABLE  System discards the resource if it is no longer
                          needed.
 
filename     Specifies the name of the file containing the icon resource. If
             the file is not in the current directory, filename must be
             preceded by a full path.
 
Example
 
This example defines a bitmap whose bitmap identifier is 12. The bitmap
resource is copied from the file custom.bmp.
 
BITMAP 12 custom.bmp
 
See Also
 
GpiLoadBitmap
 
                                      ♦