From RAD Studio API Documentation
Jump to: navigation, search



TImageList = class(TDragImageList)


class PASCALIMPLEMENTATION TImageList : public TDragImageList


Type Visibility Source Unit Parent
class public
Vcl.Controls Vcl.Controls


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

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.

See Also

Code Examples