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.v24.2.dll
Declaration
[DefaultValue("*")]
[XtraSerializableProperty]
public virtual string FindFilterColumns { get; set; }
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 |
|
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.