[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
  Prerequisites
 [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
  [Collapse]Data Grid
   [Expand]Get Started With Data Grid and Views
   [Expand]Data Binding
    Unbound Columns
   [Expand]Views
   [Expand]Data Editing and Validation
   [Expand]Grouping
   [Expand]Sorting
   [Expand]Filter and Search
   [Expand]Summaries
   [Expand]Focus and Selection Handling
    Format Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
    Split Presentation
    Row Preview Sections
   [Expand]Scrolling
   [Expand]Batch Modifications
    Hit Information
    Hints
    Popup Menus
   [Expand]Save and Restore Layout
   [Collapse]Visual Elements
    [Collapse]Grid Control Elements
      Data Navigator
      Find Panel
    [Expand]View Common Elements
    [Expand]Grid View Elements
    [Expand]Card View Elements
    [Expand]Layout View Elements
    [Expand]Banded Grid View Elements
    [Expand]Master-Detail Mode Related Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [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]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)

Find Panel

Expanded 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.

Expanded Options

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

Behavior: Filter or Search

The ColumnViewOptionsFind.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 ColumnViewOptionsFind.HighlightFindResults property.

Panel Visibility

Panel Location

The GridViewOptionsFind.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 ColumnViewOptionsFind.ParserKind and ColumnViewOptionsFind.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 ColumnViewOptionsFind.FindMode property to specify this behavior explicitly. The ColumnViewOptionsFind.FindDelay property allows you to specify the delay between entering a query and starting the search.

Expanded Server Mode Limitations

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

Expanded See Also

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