A newer version of this page is available. Switch to the current version.

Find Panel

  • 3 minutes to read

Overview

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

NOTE

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)

Options

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

Behavior: Search or Filter

The TreeList.OptionsFind.Behavior property specifies how to show search results:

  • Filter — hides records that do not match the query and highlights results in the tree list (optionally).

  • Search — highlights results in the tree list and on the scrollbar.

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

Highlight results

To specify whether search queries are highlighted, use the TreeList.OptionsFind.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 TreeList.OptionsFind.FindMode property to specify this behavior. The TreeList.OptionsFind.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 TreeList.OptionsFind.ParserKind and TreeList.OptionsFind.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

See Also