TcxCustomGridTableItem.OnGetFilterImages Event

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

Declaration

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:

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:

Delphi

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

C++

void __fastcall TMyForm::tvOrdersPaymentGetFilterImages(
  TcxCustomGridTableItem *Sender, TcxFilterValueList *AValueList,
  TCustomImageList *AImages)
{
  AImages = nullptr;
}

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