[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [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
     Column Button
     Column Header
     Column Header Context Menu
     Column Header Panel
     Column Separators
     Column Pop-up Filter Menus
     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]End User Capabilities
   [Expand]Member Tables
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst 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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Find Panel

Expanded Overview

The tree list can display a find panel that enables users to search for keywords in data.


Run the XtraTreeList demo to see the find panel in action.

Keyboard operations

Filter and Search modes

  • Press Ctrl+F to open the find panel.
  • Press Esc once to clear the panel, press it again to close it.
  • Press the Down Arrow key to move focus from the panel to the grid.

Search Mode only

  • To go to the next result press one of the following shortcuts:
    • F3
    • Enter (only if the find panel is focused)
  • To go to the previous result press one of the following shortcuts:
    • Shift+F3
    • Alt/Ctrl/Shift+Enter (only if the find panel is focused)

Expanded Options

The TreeList.OptionsFind property provides access to options specific to the find panel.

Behavior: Search or Filter

The TreeListOptionsFind.Behavior property specifies how to show search results:

If this property is set to FindPanelBehavior.Default, the behavior depends on the static (Shared in VB) WindowsFormsSettings.FindPanelBehavior property. If the latter property is also set to FindPanelBehavior.Default, the FindPanelBehavior.Filter mode is applied.

Highlight results

To specify whether search queries are highlighted, use the TreeListOptionsFind.HighlightFindResults property.

Panel visibility

Specify search queries in code

Auto-apply search queries

After a user types in the search box, the search starts automatically depending on the underlying data source. You can use use the TreeListOptionsFind.FindMode property to specify this behavior. The TreeListOptionsFind.FindDelay property allows you to specify the delay between when you enter the query and when the search starts.

Search Syntax

The search syntax can vary depending on the TreeListOptionsFind.ParserKind and TreeListOptionsFind.Condition properties. See Find Panel Syntax for more information.

Operation buttons

Use the following properties to show/hide the buttons.

Filter and Search modes

Filter mode only

Search mode only

Expanded See Also

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