[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Implementation Details
   [Expand]Grid View Data Layout
   [Expand]Binding to Data
   [Expand]Master-Detail Data Representation
   [Expand]Data Editing and Validation
   [Expand]Filtering and Searching
   [Expand]Data Summaries
   [Expand]Paging and Scrolling
   [Expand]Focus, Navigation, Selection
   [Expand]Conditional Formatting
   [Expand]Appearance Customization
   [Expand]MVVM Enhancements
   [Expand]Printing and Exporting
   [Expand]Performance Improvement
   [Expand]Design-Time Features
   [Collapse]Visual Elements
    [Collapse]Common Elements
      Data Column
      Automatic Filter Row
      Column Filter Dropdown
      Column Band Chooser
      Band Column
      Bands Panel
      Column Header Panel
      Grid Header
      Data Navigator
      Filter Panel
      MRU Filter List
      Search Panel
      Group Footer
      Group Panel
      Group Row
      New Item Row
      Summary Panel
      Footer Cell
      Cell Tooltip
      Fixed Summary Panel
      Edit Form
      Compact Panel
    [Expand]Table View Elements
    [Expand]Card View Elements
    [Expand]TreeList View Elements
   [Expand]End-User Capabilities
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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)

Search Panel

The built-in Search Panel provides an easy way to search against multiple columns.


Topic: Search



Requires installation of WPF Subscription. Download

The table below lists the main properties affecting element behavior and appearance.




DataViewBase.ShowSearchPanelMode - Specifies when the Search Panel is displayed.

By default, an end user can show and hide the Search Panel when required. To display the Search Panel, an end user should press CTRL+F or select the 'Show Search Panel' item of a column's context menu. To hide the Search Panel, an end user should do one of the following: click the Close button (if visible), use ESC (the first press clears the search box; the second press closes the Search Panel) or select the 'Hide Search Panel' item of a column's context menu.

DataViewBase.ActualShowSearchPanel - Gets whether the Search Panel is currently visible within a View.


The Search Panel is merged with the Group Panel.

Set the GridViewBase.SearchPanelPosition property to SearchPanelPosition.OverGroupPanel to show the Search Panel over the Group Panel.

Parse Modes

DataViewBase.SearchPanelParseMode - Specifies how the search string is parsed.

Result Info

Set the DataViewBase.ShowSearchPanelResultInfo property to true to show information about search results in the Search Panel.


DataViewBase.SearchPanelFindMode - Specifies whether a search starts automatically, or must be started manually (by clicking the Find button, pressing ENTER or moving focus from the search panel).

DataViewBase.SearchDelay - Specifies the amount of time in milliseconds after which a data search is initiated (in an automatic find mode).

DataViewBase.SearchPanelFindFilter - Specifies the type of the comparison operator used to create filter conditions.

Search String

Searches are performed against a string specified by an end-user in a Find Panel's edit box. To specify a search string in code, use the DataViewBase.SearchString property.

Search Columns

DataViewBase.SearchColumns. By default, this property is set to "*". In this instance, a search is performed against all visible columns. To search against specific columns, specify the corresponding field names, delimiting them with the ";" character. You can also use the ColumnBase.AllowSearchPanel property to specify whether the column data is taken into account when using the search panel.

Search Results

DataViewBase.SearchPanelHighlightResults - Specifies whether search strings within the located records should be highlighted.


DataViewBase.SearchPanelAllowFilter - Specifies whether the grid displays only those records that match the search criteria.


DataViewBase.ShowSearchPanelCloseButton, DataViewBase.ShowSearchPanelFindButton, DataViewBase.ShowSearchPanelMRUButton, DataViewBase.ShowSearchPanelNavigationButtons

Null Text




Keyboard Operations

CTRL+F - Invokes the Search Panel (if the DataViewBase.ShowSearchPanelMode property is set to ShowSearchPanelMode.Default).

ESC - Clears the search box. If the search box is empty, pressing ESC closes the Search Panel.

DOWN ARROW - Moves focus from the Search Panel to the grid's data area.

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