VGridOptionsFind.FindFilterColumns Property

Gets or sets the field names against which searches are performed by the Find Panel.

Namespace: DevExpress.XtraVerticalGrid.Rows

Assembly: DevExpress.XtraVerticalGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.VerticalGrid

Declaration

C#

[DefaultValue("*")]
[XtraSerializableProperty]
public virtual string FindFilterColumns { get; set; }

VB.NET

<DefaultValue("*")>
<XtraSerializableProperty>
Public Overridable Property FindFilterColumns As String

Property Value

Type	Default	Description
String	"*"	A string specifying the field names against which searches are performed.

Property Paths

You can access this nested property as listed below:

Object Type	Path to FindFilterColumns
VGridControlBase	.OptionsFind .FindFilterColumns

Remarks

If the FindFilterColumns property is set to “*”, the Find Panel performs searches against all visible items.

To explicitly specify search field names, set the FindFilterColumns property to a string consisting of the corresponding field names delimited by a semicolon (without space characters): “Name;Value;Description”.

Note

In Server Mode, searches are performed against column values, not by column display text. For columns that use specific in-place editors (e.g., lookup editors (see LookUpEditBase) and ImageComboBoxEdit editors), column values typically do not match the column display text. Searching against these columns is not supported. Note, however, that the grid may still highlight a search string in these columns, because text is highlighted at the grid level, while searching/filtering is performed at the data store level. If you do not want text to be highlighted in non-searchable columns, we suggest that you explicitly limit the search columns with the ColumnViewOptionsFind.FindFilterColumns property.

If you still need to search against a non-searchable column, you can create a data source field whose values match the display text of the non-searchable column’s cells. Assign this field’s name to the column’s GridColumn.FieldNameSortGroup property.

Note

In Server Mode, data searching via the Find Panel for columns whose data type is neither string nor numeric is not supported.