Skip to main content

Filter Panel and Filter Editor

The filter panel is automatically displayed when a filter condition is applied to data and allows an end-user to manage the applied filter. It contains the following buttons:

  • Close Filter button - closes the filter panel and removes the filter;
  • Enable Filter button - temporarily enables and disables the current filter;
  • MRU Filter button - invokes the list of most recently used filters. This list can also be opened by clicking the filter text within the panel;
  • Edit Filter button - opens the filter editor allowing end-users to build complex filter criteria;



The figure below illustrates the style of the VGrid filter panel and its MRU list when the WindowsFormsSettings.FilterCriteriaDisplayStyle property equals Visual.

MRU Filter list

The table below lists the main properties that affect an element’s appearance.


The VGridControl.Appearance.FilterPanel property.

Custom Draw Event

The VGridControl.CustomDrawFilterPanel event.


The VGridControl.OptionsView.ShowFilterPanelMode option.


The VGridControl.CustomFilterDisplayText event.

MRU Filter List

The VGridControl.MRUFilters collection.

The VGridControl.OptionsFilter.MRUFilterListCount property.

The VGridControl.OptionsFilter.MRUFilterListPopupCount property.

Visibility of the MRU Filter button

The VGridControl.OptionsFilter.AllowMRUFilterList option.

Visibility of the Edit Filter button

The VGridControl.OptionsFilter.AllowFilterEditor option.

Display Style

The VGridControl.OptionsView.FilterCriteriaDisplayStyle and WindowsFormsSettings.FilterCriteriaDisplayStyle options.

Invoking the Filter Editor

The VGridControl.ShowFilterEditor method.

Filter Editor Customization

The VGridControl.FilterEditorCreated event.

Filter Editor View

The VGridControl.OptionsFilter.DefaultFilterEditorView option.