The 'imagenames' property

Not implemented under MacOS

See below for data format

Valid for: ImageList

The imagenames property assign images to the ImageList object. It accepts any of the following data forms:

• A character vector giving an image file name (a bitmap, cursor, or icon file).
• An integer matrix of N by M pixel COLORVAL color values.
• A pair of character vectors, the first giving an image file name, the second giving a transparency mask image file name.
• A pair of data items, the first a character vector giving an image file name, the second indicating which color should be regarded as transparent. The format of the second element can be either ('color' COLORVAL) or ('color' R G B).
• A pair of integer matrices, the first giving pixel color values, the second giving a transparency mask.
• A pair of data items, the first an integer matrix of pixel color values, the second indicating a transparency color in the form ('color' COLORVAL) or ('color' R G B).
• A nested vector of multiple instances of the above.

In the above descriptions, R G and B are individual Red, Green and Blue color values, each in the range 0 to 255. COLORVAL is a single integer encoding the color as 256 ⊥ Blue Green Red.

A single bitmap can optionally contribute multiple images to the ImageList, laid side by side. To do this, you need first to set the imagesize property to be the size of the image. Any bitmap of a width N times the width specified in imagesize will then contribute N images to the list.

Note: The imagenames property and the Addimages method are alternative ways of setting the list of images. The imagenames property is persistent, and is used to refill the image list after any change which would normally clear it (such as setting the imagesize property).