DataViewBase.ShowSearchPanelMode Property

Gets or sets a value that specifies when the Search Panel is displayed.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.2.Core.dll

Declaration

public ShowSearchPanelMode ShowSearchPanelMode { get; set; }

Property Value

Type Description
ShowSearchPanelMode

A ShowSearchPanelMode enumeration member that specifies when the Search Panel is displayed.

Available values:

Name Description
Default

Never if the GridControl is bound to a virtual source; otherwise, HotKey.

HotKey

Ctrl + F - Invokes the Search Panel. Ensure that no cell editor is opened before invoking the Search Panel. Otherwise, the shortcut will be intercepted by the in-place editor.

The Close button (if displayed) hides the Search Panel.

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

Always

The Search Panel is always visible, it cannot be hidden by an end-user. The close button is hidden.

Never

The Search Panel is hidden and cannot be shown by the end-user.

Remarks

Tip

Topic: Search

Set the ShowSearchPanelMode property to ShowSearchPanelMode.Always to always display the Search Panel.

Set the ShowSearchPanelMode property to ShowSearchPanelMode.Never to prohibit users from displaying the Search Panel.

To display the Search Panel, a user should do one of the following:

  • Press Ctrl + F.
  • Click the Show Seacrh Panel button ( ).
  • Select the Show Search Panel item in a column’s context menu.

To hide the Search Panel, a user should do one of the following:

  • Press Esc (the first press clears the search box; the second press closes the Search Panel).
  • Click the Close button ( ).
  • Select the Hide Search Panel item in a column’s context menu.

To move focus from the Search Panel to the grid’s data area, a user should press Down Arrow.

To show the MRU search drop-down list, a user should press Alt + Down Arrow.

See Also