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

TcxCustomGridTableItem.OnGetFilterImages Event

In This Article

Allows you to replace images displayed in the grid table item’s filter pop-up window.

#Declaration

Delphi
property OnGetFilterImages: TcxGridGetFilterImagesEvent read; write;

#Remarks

The grid table item’s filter pop-up window automatically displays images for filter items if the grid item uses a TcxImageComboBox instance as an in-place editor. The filter pop-up window retrieves filter item images from the image list assigned to the editor’s Properties.Images property:

Automatically Displayed Filter Item Images

Handle the OnGetFilterImages event to replace automatically displayed filter item images or display images for filter items if the grid item does not use an Image Combo Box as an in-place editor. Additionally, you can rearrange displayed images or hide them for specific filter items. If you need to hide automatically displayed filter item images, assign nil (in Delphi) or nullptr (in C++Builder) to the AImages parameter within an OnGetFilterImages event handler:

procedure TMyForm.tvOrdersPaymentTypeGetFilterImages(
  Sender: TcxCustomGridTableItem; AValueList: TcxFilterValueList;
  var AImages: TCustomImageList);
begin
  AImages := nil;
end;

Refer to the TcxGridGetFilterImagesEvent procedural type description for an additional code example and detailed information on parameters accessible within an OnGetFilterImages event handler.

See Also