[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
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Collapse]Tree List
   [Expand]Product Information
   [Expand]Feature Center
   [Collapse]Visual Elements
     Automatic Filtering Row
     Blank Column
     Caption Panel
     Cell
     Column
     Column Button
     Column Header
     Column Header Context Menu
     Column Header Panel
     Column Separators
     Column's Filter DropDown
     Customization Form
     Empty Area
     Expand Button
     Filter Button
     Filter Editor
     Filter Panel
     Find Panel
     Fixed Line
     Footer Cell
     Footer Context Menu
     Group Footer
     Node Image
     Node Indents
     Node Indicator Panel
     Summary Footer
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End User Capabilities
   [Expand]Member Tables
  [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]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
WinForms Controls > Controls and Libraries > Tree List > Visual Elements > Filter Panel

Filter Panel

The filter panel displays a string representation of the filter criteria applied to a TreeList. 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 element appearance.

Appearance TreeListAppearanceCollection.FilterPanel
Custom Draw Event TreeList.CustomDrawFilterPanel
Visibility TreeListOptionsView.ShowFilterPanelMode

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

Visibility of the MRU Filter Button TreeListOptionsFilter.AllowMRUFilterList
Visibility of the Edit Filter Button TreeListOptionsFilter.AllowFilterEditor
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 TreeList.FilterPanelText property. You can provide custom filter display text for a filter condition by handling the TreeList.CustomFilterDisplayText event.

Is this topic helpful?​​​​​​​
Copyright (c) 1998-2018 Developer Express Inc. All rights reserved.