Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomImageList.Replace(Integer,TGraphic,TBitmap) Method

Replaces a specific image within the list with a specified image.

#Declaration

Delphi
procedure Replace(AIndex: Integer; AImage: TGraphic; AMask: TBitmap);

#Parameters

Name Type Description
AIndex Integer

The position within the image list.

AImage TGraphic

The source image container.

AMask TBitmap

The transparency mask bitmap.

#Remarks

This function divides the loaded image into multiple images or truncates it to match the list’s dimensions as the Add function does.

This function allows you to pass a transparency mask bitmap for the appended image as the AMask parameter. To omit the mask, pass nil (in Delphi) or nullptr (in C++Builder).

Note

The transparency mask bitmap is ignored if the Masked property is set to False.

See Also