Filter Builder Dialog

Jul 29, 2021
2 minutes to read

The Filter Builder dialog allows end-users to:

Build complex filter criteria with an unlimited number of filter conditions combined by logical operators.
Save filter criteria to files, and restore previously saved criteria at a later point.

Feature

Related Members

| | --- | --- | |

Availability

End-users can invoke the Filter Builder dialog using the following methods:

Clicking the Customize… button displayed in the filter panel;
Selecting the (Custom…) item in the filter dropdown provided that the Custom Filter dialog cannot display the filter condition applied to the corresponding column or card row;
Clicking the Filter button in the View navigator.

To invoke the Filter Builder dialog in code, use the View’s Filtering.RunCustomizeDialog method without the parameter.

You can prevent the grid View from displaying the Filter Builder dialog or display a custom dialog instead by handling the View’s OnFilterCustomization or OnFilterDialogShow event.

| |

Content

Handle the View’s OnFilterControlDialogShow event to customize the Filter Builder dialog’s content before the dialog is invoked.

You can customize the caption of columns or card rows displayed in the dialog via their AlternateCaption property.

| |

Appearance

The look and feel of the controls displayed within the Filter Builder dialog depends on the grid control’s LookAndFeel property settings.

Refer to the Using Filter Builder Dialog topic for additional information.