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

Find Panel

  • 4 minutes to read

Overview

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

NOTE

Run the XtraGrid 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

  • press F3/Enter to go to the next result
  • press Shift/Alt/Ctrl+F3/Enter to go to the previous result
NOTE

A detail view should be maximized to allow searching its records.

TIP

The GridLookUpEdit does not support the find panel, use the SearchLookUpEdit.

Options

The ColumnView.OptionsFind property provides access to options related to the find panel.

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

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

  • Search — highlights results in the view 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 ColumnView.OptionsFind.HighlightFindResults property.

Panel Visibility

Panel Location

The GridView.OptionsFind.FindPanelLocation property specifies where the panel is displayed:

The default location depends on the Version Compatibility setting. Since version 19.2, the find panel is embedded into the group panel.

Specify Search Queries in Code

Search Syntax

The search syntax may vary depending on the GridView.OptionsFind.ParserKind and GridView.OptionsFind.Condition properties. See Find Panel Syntax for more information.

Operation Buttons

Use the following properties to show/hide the operation buttons:

Apply Search Queries

After a user types in the search box, the search starts automatically or manually depending on the underlying data source. You can use use the ColumnView.OptionsFind.FindMode property to specify this behavior explicitly. The ColumnView.OptionsFind.FindDelay property allows you to specify the delay between entering a query and starting the search.

Server Mode Limitations

The find panel has the following limitations in the server mode:

See Also