This operation works in the same way as the WBITMAP-LOAD operation, except that the returned handle is a Win32 API ImageList handle instead of a bitmap handle. This handle can be directly used by ActiveX controls which use ImageLists, and should be USAGE COMP-5. When running under the thin client, the resulting ImageList resides on the desktop machine. The ImageList handle is only meaningful to software components on that machine (such as a displayed ActiveX control). Unlike images loaded with WBITMAP-LOAD, the runtime does not track ImageLists. For this reason, you should destroy an ImageList once you no longer need it. Error values returned by this operation are identical to those returned by the WBITMAP-LOAD operation. This operation takes up to three additional parameters:


This required alphanumeric literal is the name of the file you wish to load. It should be a BMP or JPG file. The file is handled in exactly the same fashion as it is for the WBITMAP-LOAD operation.


This numeric parameter is optional. The bitmap file is treated as a series of distinct images arranged horizontally. The height of each image is determined by the height of the bitmap. The width of each image is defined by this parameter, expressed in pixels. Each image must be the same width. If omitted, a default width of 16 pixels (a common width for toolbar images) is used.


Restriction: This property is supported for BMP and PNG image formats only; it is not supported for JPG or GIF formats.

This optional numeric literal is set to the value of a color that you designate as a "transparent" color. Pixels of this color are not displayed when the bitmap is drawn, allowing the background to show through. Color values are expressed as integers composed of red, green and blue components. The mathematical expression for the composite value is:

(blue * 65536) + (green * 256) + (red)

where red, green, and blue are values between 0 and 255. You can use a hexadecimal numeric literal to express this value since each component of the color occupies one byte in a binary value. For example, "x#FF8000" expresses an orange color with red at 255, green at 128, and blue at 0. The first byte (x 'FF') is the red value, the second byte (x'80') is the green value, and the last byte (x'00') is the blue value.

Note: The value "x#C0C0C0" is often used for the transparent color since this is the medium gray shade used in default Windows color schemes. Images drawn using this as a background color adapt well when the user changes from the default color scheme.

If this parameter is omitted, all colors are treated as usual and the image is drawn without modification.