[Overview][Types][Classes][Procedures and functions][Index] | Reference for unit 'ImgList' (#lcl)

# TCustomImageListResolutions

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

Provides multiple image resolutions in TCustomImageList.

## Declaration

Source position: imglist.pp line 224

`type TCustomImageListResolutions = class(TObject)`
`public`
`constructor Create();` |  | Constructor for the class instance.
`destructor Destroy; override;` |  | Destructor for the class instance.
`function FindBestToScaleFrom();` |  | Finds the image resolution with the best size for scaling to the target width.
`procedure Delete();` |  | Deletes the image resolution stored at the specified position in the container.
`procedure Clear;` |  | Clears all image resolutions stored in the container.
`property ImageLists []: TCustomImageListResolution; [r]` |  | Provides access to an image list which uses the specified image width.
`property Items []: TCustomImageListResolution; default; [r]` |  | Provides indexed access to existing image resolutions in the container.
`property Count: Integer; [r]` |  | Number of image resolutions stored in the container.
`end;`

## Inheritance

`TCustomImageListResolutions` |  | Provides multiple image resolutions in TCustomImageList.
`TObject`

## Description

TCustomImageListResolutions is a class used to implement support for multiple image sizes (or resolutions) in TCustomImageList. TCustomImageListResolutions maintains an internal list with TCustomImageListResolution class instances representing each of the image sizes (and the raw image data for the size) available in the TCustomImageList instance. In essence, it allows TCustomImageList to treat each image resolution as a distinct parallel image list.

The ImageLists property provides access to the image list for a specific image width (or resolution), and performs image scaling when needed. New image resolutions are dynamically created and added to the container when a size is requested that is not already present.

Use the Items property to access the TCustomImageListResolution class instances stored in the container. Use the Count property to determine the number of image resolutions stored in the container. Use the Clear and Delete methods to maintain image resolutions in the container.

TCustomImageListResolutions is used in the implementation of TCustomImageList.

## See also

TCustomImageListResolution |  | Implements an image resolution (or size) used in TCustomImageList.
TCustomImageListResolutions.ImageLists |  | Provides access to an image list which uses the specified image width.
TCustomImageListResolutions.Items |  | Provides indexed access to existing image resolutions in the container.
TCustomImageList.Width |  | Width of images in the default resolution for the image list.
TCustomImageList.Resolution |  | Provides indexed access to an image resolution with the specified image width.
TCustomImageList.Resolutions |  | Provides access to the image resolutions (or sizes) used in the image lists.