BITMAP Statement

Syntax:

  BITMAP bitmap-id [load-option] [mem-option] [codepage] filename

The BITMAP statement defines a bit map resource for an application. A bit map resource, typically created using the Icon Editor, is a custom bit map that an application uses in its display or as an item in a menu. The BITMAP statement copies the bit-map resource from the file specified in the filename field and adds it to the application's other resources. A bit-map 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 script file, but each statement must specify a unique bitmap-id value.

bitmap-id

Specifies the bit-map-resource identifier. This value must be an unsigned integer in the range of 1 through 65535, a simple expression that evaluates to a value in these ranges, or a character string.
load-option
Specifies when the system loads the resource from the executable file into memory. This value must be one of the following: 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 option.
mem-option
Specifies how the system manages the resource when it is in memory. This value must be one of the following: FIXED
System keeps the resource at a fixed memory location.
MOVEABLE
System moves the resource as necessary to compact memory. This is the default option.
DISCARDABLE
System discards the resource if it is no longer needed.
codepage
Specifies a code page value. For a list of valid code pages see CODEPAGE Statement.
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 bit map whose bit-map identifier is 12. The bit-map resource is copied from the file CUSTOM.BMP.

  BITMAP 12 custom.bmp

---

[Back: AUTORADIOBUTTON Statement]
[Next: CHECKBOX Statement]