TcxCustomGridTableView.OnFilterCustomization Event

Enables you to prevent the Filter Builder dialog from being displayed or substitute it with your own dialog.

Declaration

property OnFilterCustomization: TcxGridFilterCustomizationEvent read; write;

Remarks

The OnFilterCustomization event is raised by Views whenever the Filter Builder dialog is about to be displayed. The View whose filter dialog is being displayed is identified by the Sender parameter. The ADone parameter specifies whether the dialog should be displayed. Set this parameter to True if you don’t need to show the dialog. This can be used if you need to display your own form instead of the Filter Builder dialog. The default value of this parameter is False.

If you don’t need to show your own dialog but need to customize the existing dialog before it is displayed, handle the OnFilterControlDialogShow event.

Note

Normally, pressing the Custom item within a column’s filter dropdown invokes the Custom Filter dialog. In such cases, the OnFilterCustomization event is not raised. You should handle the OnFilterDialogShow event to perform the same tasks. At the same time, if more than two filter conditions have already been applied to the column, pressing the dropdown’s Custom item invokes the Filter Builder dialog and raises the OnFilterCustomization event.