[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Collapse]Tree List
   [Expand]Product Information
   [Collapse]Concepts
    [Expand]Binding to Data
    [Expand]Data Representation Basics
    [Expand]Data Editing
    [Collapse]Data Shaping and Manipulation
     [Expand]Data Summaries
     [Expand]Sorting
     [Collapse]Filtering
       Filtering in Code
       Filter Row
       Filter Control
       Search Panel
       Header Filter
     Drag and Drop
    [Expand]Focus and Navigation
     Appearance Customization
     Save and Restore Layout
    [Expand]Templates
     Toolbars
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Member Tables
  [Expand]Card View
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Gauges
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Filter Row

The Filter Row allows end-users to filter data nodes by typing text directly into the row. To display the Filter Row at the top of the ASPxTreeList, set the TreeListSettings.ShowFilterRow property to true.

The Filter Row can work in either Auto or OnClick mode based on the TreeListSettingsBehavior.FilterRowMode property value.

In Auto mode, the filter is applied on the fly when an end-user types text within a row. By default, the filter is updated after 1200 milliseconds. To change the time interval between the times the user starts typing within the Filter Row and when filtering is applied, use the TreeListSettingsBehavior.AutoFilterRowInputDelay property.

In OnClick mode, the filter is applied on the Apply button click.

You can access the applied filter expression using the ASPxTreeList.FilterExpression property.

Filter row buttons allow end-users to select filter criteria from the drop-down filter row menu. To control button visibility, use the TreeListSettings.ShowFilterRowMenu property.

The applied filter criteria are displayed in the filter bar that is hidden by default. To display it, set the TreeListSettings.ShowFilterBar property to true. Handle the ASPxGridBase.CustomFilterExpressionDisplayText event to display custom text within the filter bar.

Expanded Auto Filter Row Cell Editors

By default, editors used to edit cell values within the filter row are the same as the editors used to edit values of corresponding columns. ASPxTreeList allows you to replace these default editors with custom editors using the ASPxTreeList.AutoFilterCellEditorCreate event.

This event is raised for each cell within the filter row. The event parameter provides the Column property (which identifies the processed filter row cell), and the Value property (which returns the processed cell's value). To replace the settings used to create the default editor, create the EditPropertiesBase descendant, and assign it to the event parameter's EditorProperties property.

To initialize cell editors (default and/or custom) displayed within the filter row, handle the ASPxTreeList.AutoFilterCellEditorInitialize event. This event is raised before the filter row is displayed within ASPxTreeList.

Online Demos

Refer to the following online demos to review how to filter Tree List data nodes using the Filter Row.

Is this topic helpful?​​​​​​​