## 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).

Topic: APLX Help : System Classes : Properties : imagenames

[ Previous | Next | Contents | Index ]