RAD Studio VCL Reference
TImageList Class

TImageList represents a collection of same-sized images, each of which can be referred to by its index.

TImageList = class(TDragImageList);
class TImageList : public TDragImageList;

Image lists are used to efficiently manage large sets of icons or bitmaps. All images in an image list are contained in a single, wide bitmap in screen device format. An image list may also include a monochrome bitmap that contains masks used to draw images transparently (icon style).  

The image list is capable of holding a large number of same sized images and retrieving them via their index within the range 0 to n - 1. The image list also has methods to facilitate storing, retrieving, and drawing of the stored images. 

To add images to an image list at design time, right click and choose Image List Editor. 

Images in the list may be bitmaps, icons, PNG, GIF and JPEG images: any image type that TImage supports. ImageLists also support 32-bit format, so alpha blended bitmaps and PNG files work properly.

Note: Changing the color depth of an already existing image list clears its contents.
Note: Image lists depend on Comctl32.dll. If the system does not have the latest version installed, there may be problems getting images to appear.


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!