Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Expand]View Technology
   [Expand]Grouping
   [Expand]Sorting
   [Expand]Summaries
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Hints
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Collapse]Visual Elements
    [Expand]Grid Control Elements
    [Collapse]View Common Elements
      New Item Row/Card
      Filter Panel
      Filter Panel Close Button
      View's MRU Filter List
      Edit Filter Button
      Filter Editor
      Column's Filter DropDown
      Custom Filter Dialog
      View Caption
    [Expand]Grid View Elements
    [Expand]Card View Elements
    [Expand]Layout View Elements
    [Expand]Banded Grid View Elements
    [Expand]Master-Detail Mode Related Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Filter Panel

The filter panel displays a string representation of the filter criteria applied to a View. It can contain the following buttons:

  • Close Filter Button - closes the filter panel clearing the filter;
  • Enable Filter Button - can be used to temporarily disable and enable the current filter;
  • MRU Filter Button - provides access to the most recently used filters that are displayed within the MRU filter dropdown list. 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 table below lists the main properties that affect an element's appearance.

Appearance The ColumnViewAppearances.FilterPanel property.
Custom Draw Event The ColumnView.CustomDrawFilterPanel event.
Visibility The ColumnViewOptionsView.ShowFilterPanelMode option.

By default, the filter panel is only visible if a filter is applied to a View.

Visibility of the MRU Filter Button The ColumnViewOptionsFilter.AllowMRUFilterList option.
Visibility of the Edit Filter Button The ColumnViewOptionsFilter.AllowFilterEditor option.
Contents

The text displayed within the panel is comprised of the text from the filters of individual columns, plus the filter that is not bound to any column. To access the filter display text, use the ColumnView.FilterPanelText property. You can provide custom filter display text for a filter condition when creating this filter condition in code (using the ColumnFilterInfo constructor which takes the 'displayText' parameter). It is also possible to provide a custom filter display for the overall filter criteria by handling the ColumnView.CustomFilterDisplayText event.

Expanded See Also

How would you rate this topic?​​​​​​​