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)
Behavior: Search and Filter
You can specify how to show search results.
- Filter — hides records that do not match the query, and optionally highlights results in the tree list.
- Search — highlights results in the tree list and on the scrollbar.
Use the following properties to specify how to show search results:
- for the entire application — the static (Shared in Visual Basic) WindowsFormsSettings.FindPanelBehavior property. The
Filter
mode is applied if this setting is set toDefault
. - for the current control — the Behavior property. The static (Shared in Visual Basic) WindowsFormsSettings.FindPanelBehavior property is applied if this setting is set to
Default
.
Options
The TreeList.OptionsFind property provides access to options specific to the find panel.
Panel visibility
- TreeList.ShowFindPanel() — opens the panel.
- TreeList.HideFindPanel() — closes the panel.
- TreeList.OptionsFind.AllowFindPanel — gets or sets whether users can invoke the panel with Ctrl+F.
- TreeList.OptionsFind.AlwaysVisible — gets or sets whether the panel is shown/hidden with Ctrl+F, or always visible.
Specify search queries in code
- TreeList.ApplyFindFilter(System.String) — fills in the find panel with the specified query and applies it.
- TreeList.ClearFindFilter — discards the query and clears the find panel.
- TreeList.CustomRowFilter — allows you to specify node visibility regardless of the currently applied filter.
- TreeList.OptionsFind.FindFilterColumns — names of columns in which to search the keywords.
Highlight results
To specify whether search queries are highlighted, use the TreeList.OptionsFind.HighlightFindResults property.
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
- TreeList.OptionsFind.ShowCloseButton - the X button closes the panel.
Filter mode only
- TreeList.OptionsFind.ShowFindButton - the Find button applies the query.
- TreeList.OptionsFind.ShowClearButton - the Clear button.
Search mode only
- TreeList.OptionsFind.ShowSearchNavButtons - the Previous and Next buttons allow users to navigate between search results.