Search Panel
- 3 minutes to read
The built-in Search Panel allows users to search against multiple columns.
The sections below list properties that affect Search Panel element behavior and appearance.
Visibility
- DataViewBase.ShowSearchPanelMode
- Gets or sets a value that specifies when the Search Panel is displayed.
- DataViewBase.ActualShowSearchPanel
- Gets whether the Search Panel is displayed within a View. This is a dependency property.
Position
The Search Panel is merged with the Group Panel.
Set the GridViewBase.SearchPanelPosition property to SearchPanelPosition.OverGroupPanel to display the Search Panel over the Group Panel.
Parse Modes
- DataViewBase.SearchPanelParseMode
- Gets or sets a mode that specifies how the search string is parsed. This is a dependency property.
Result Info
- DataViewBase.ShowSearchPanelResultInfo
- Gets or sets whether to show information about search results in the search panel.
Search Modes and Delay
- DataViewBase.SearchPanelFindMode
- Gets or sets whether data searching starts automatically, or must be started manually. This is a dependency property.
- DataViewBase.SearchDelay
- Gets or sets the amount of time in milliseconds, after which a data search is initiated (in an automatic find mode). This is a dependency property.
Search String
- DataViewBase.SearchString
- Gets or sets the search string specified within the Search Panel. This is a dependency property.
Search Results
- DataViewBase.SearchPanelHighlightResults
- Gets or sets whether to highlight search results within located records. This is a dependency property.
Filtering
- DataViewBase.SearchPanelAllowFilter
- Gets or sets whether the grid displays only those records that match the search criteria. This is a dependency property.
- DataViewBase.SearchPanelFindFilter
- Gets or sets the type of the comparison operator used to create filter conditions. This is a dependency property.
Buttons
- DataViewBase.ShowSearchPanelCloseButton
- Gets or sets whether to display the Close button within the Search Panel.
- DataViewBase.ShowSearchPanelFindButton
- Gets or sets whether to display the Find button within the Search Panel.
- DataViewBase.ShowSearchPanelMRUButton
- Gets or sets whether a button used to invoke the MRU search dropdown list is displayed within the Search Panel. This is a dependency property.
- DataViewBase.ShowSearchPanelNavigationButtons
- Gets or sets whether to show navigation buttons in the grid’s search panel.
Null Text
- DataViewBase.SearchPanelNullText
- Gets or sets the text displayed within the search panel edit box when the search text is null. This is a dependency property.
Alignment
- DataViewBase.SearchPanelHorizontalAlignment
- Gets or sets the Search Panel‘s alignment. This is a dependency property.
Custom Content
Add custom UI elements (a label, icon, or button) next to the search box.
- GridDataViewBase.SearchPanelLeftContentTemplate
- Gets or sets the template used to display additional UI elements to the left of the Search Panel. This is a dependency property.
- GridDataViewBase.SearchPanelRightContentTemplate
- Gets or sets the template designed to display additional UI elements to the right of the Search Panel. This is a dependency property.
Width
Constrain the Search Panel width to a specific range (in pixels).
- GridDataViewBase.SearchPanelMinWidth
- Gets or sets the Search Panel minimum width (in pixels). This is a dependency property.
- GridDataViewBase.SearchPanelMaxWidth
- Gets or sets the Search Panel maximum width (in pixels). This is a dependency property.
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, press Esc to close the Search Panel.
Down Arrow - Moves focus from the Search Panel to the grid’s data area.