Skip to main content

VGridOptionsView.FilterCriteriaDisplayStyle Property

Gets or sets the display style of filter conditions in the Filter Panel, MRU Filter List and built-in Filter Editor.

Namespace: DevExpress.XtraVerticalGrid

Assembly: DevExpress.XtraVerticalGrid.v24.1.dll

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

Declaration

[DefaultValue(FilterCriteriaDisplayStyle.Default)]
[XtraSerializableProperty]
public FilterCriteriaDisplayStyle FilterCriteriaDisplayStyle { get; set; }

Property Value

Type Default Description
FilterCriteriaDisplayStyle Default

The display style of filter conditions in the Filter Panel and built-in Filter Editor. When the FilterCriteriaDisplayStyle property is set to Default, the actual display style is specified by the static WindowsFormsSettings.FilterCriteriaDisplayStyle property.

Available values:

Name Description
Default

When a control’s FilterCriteriaDisplayStyle property is set to Default, the actual display style is specified by the WindowsFormsSettings.FilterCriteriaDisplayStyle property.

For the Report Designer and Dashboard Designer, the default display style is Visual.

For other controls, the default display style is Visual starting from v21.1; in older versions, the default display style is Text.

Visual

Renders filter criteria in an easy-to-read format and uses skin-based colored highlights to differentiate between column names, functions, and values. In the Filter Panel, the ‘x’ button is displayed when you hover over a condition. This button allows users to remove individual conditions from the filter.

image

Text

Renders filter criteria in a text-based format.

image

Property Paths

You can access this nested property as listed below:

Object Type Path to FilterCriteriaDisplayStyle
VGridControl
.OptionsView .FilterCriteriaDisplayStyle

Remarks

Use the static WindowsFormsSettings.FilterCriteriaDisplayStyle property to specify the default display style of filter criteria for controls in your application (Data Grid, Tree List, Vertical Grid, Pivot Grid and Filter Editors). Individual grid and tree list controls override this setting if you set their FilterCriteriaDisplayStyle property to any value except Default.

The following list demonstrates the available display styles of filter criteria in controls.

  • Visual -

    Renders filter criteria in an easy-to-read format and uses skin-based colored highlights to differentiate between column names, functions, and values. In the Filter Panel, the ‘x’ button is displayed when you hover over a condition. This button allows users to remove individual conditions from the filter.

    image

  • Text -

    Renders filter criteria in a text-based format.

    image

Note

You can bind a standalone Filter Control to a data-aware control (Grid, Tree List, etc.) with the SourceControl property (FilterControl.SourceControl, FilterEditorControl.SourceControl). When you change the data-aware control’s FilterCriteriaDisplayStyle property at runtime, the standalone Filter Control does not automatically update its appearance to match the new display style. To forcibly update the Filter Control’s appearance, call the Filter Control’s LayoutChanged method.

See Also