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

# TCustomImageList.Initialize

Performs the initial set up for the image list.

## Declaration

Source position: imglist.pp line 313

`protected procedure TCustomImageList.Initialize; virtual;`

## Description

Initialize is a procedure used to perform the in ital set up for the image list. Initialize creates the internal TCustomImageListResolutions class instance used to store image resolutions in the image list. The internal list used for TChangeLink notifications is also created. The internal allocation block count is set to 4.

Initialize sets the default values for the following properties:

BlendColor
  clNone
BkColor
  clNone
DrawingStyle
  dsNormal

The ClearOverlays method is called to reset any images assigned as overlay images in the image list.

Initialize is used in the Create and CreateSize constructors. Create sets the default values for the Height and Width properties to 16. CreateSize uses the arguments passed to the constructor as the value for the properties.

## Errors

Initialize raises an EInvalidOperation exception if the value in the Height or Width property is invalid. Height must be in the range 1..32768, and Width must be a positive non-zero Integer value. Raised with the message in SInvalidImageSize.

## See also

TCustomImageList.Create |  | Constructor for the class instance.
TCustomImageList.CreateSize |  | Initializes the image list using the specified height and width.
TCustomImageList.ClearOverlays |  | Clears images indexes assigned as overlay images in the image list.
TCustomImageList.Overlay |  | Assigns an overlay index for the specified image in the image list.
TCustomImageListResolutions |  | Provides multiple image resolutions in TCustomImageList.
TChangeLink |  | Performs notifications when images are added or deleted in TImageList.