ColumnViewOptionsFilter.ColumnFilterPopupMode Property
Gets or sets the default display mode of filter dropdowns for columns in the current View.
Namespace: DevExpress.XtraGrid.Views.Base
Assembly: DevExpress.XtraGrid.v20.2.dll
NuGet Package: DevExpress.Win.Grid
Declaration
[DefaultValue(ColumnFilterPopupMode.Default)]
[XtraSerializableProperty]
public ColumnFilterPopupMode ColumnFilterPopupMode { get; set; }
Property Value
Type | Default | Description |
---|---|---|
ColumnFilterPopupMode | **Default** | A value that specifies the default display mode of filter dropdowns for columns in the current View. |
Available values:
Name | Description |
---|---|
Default | The type of column filter menus depends on the global WindowsFormsSettings.ColumnFilterPopupMode setting. |
Excel | Columns display Excel-style filter menus. |
Classic | Columns display classic drop-down filter menus. |
Property Paths
You can access this nested property as listed below:
Object Type | Path to ColumnFilterPopupMode |
---|---|
AdvBandedGridView |
|
BandedGridView |
|
ColumnView |
|
CardView |
|
GridView |
|
LayoutView |
|
TileView |
|
WinExplorerView |
|
Remarks
Column filter dropdowns can be presented using the following display modes (the first two modes are also called classic).
- Regular list
- Calendar (for date-time columns) - A window with an embedded calendar along with predefined filter items for quick selection of common date intervals
- Checked list
- MS Excel-inspired style
The style of column filter dropdowns can be set at three levels.
Application level
The static WindowsFormsSettings.ColumnFilterPopupMode property specifies the default column filter dropdown style for all GridControls in your application.
Control level
The current property (ColumnViewOptionsFilter.ColumnFilterPopupMode) specifies the default column filter dropdown style in a certain View. This setting overrides the WindowsFormsSettings.ColumnFilterPopupMode global setting.
Column level
A column’s OptionsColumnFilter.FilterPopupMode property (GridColumn.OptionsFilter.FilterPopupMode) specifies the filter dropdown style for a specific column. This setting overrides the ColumnViewOptionsFilter.ColumnFilterPopupMode setting.
The ColumnViewOptionsFilter.ColumnFilterPopupMode property can be set to one of the following values:
- Default - The actual column filter dropdown style is specified by the WindowsFormsSettings.ColumnFilterPopupMode global setting.
- Classic - Sets classic display styles as default in the current View. The classic presentation styles will be applied to columns that have the GridColumn.OptionsFilter.FilterPopupMode property set to Default. Otherwise, column filter dropdowns will be presented according to the GridColumn.OptionsFilter.FilterPopupMode property.
- Excel - Sets the MS Excel-inspired filter dropdown style as default in the current View. This presentation mode will be applied to columns that have the GridColumn.OptionsFilter.FilterPopupMode property set to Default. Otherwise, column filter dropdowns will be presented according to the GridColumn.OptionsFilter.FilterPopupMode property.
For more details on Excel-inspired filter dropdowns, see Filter and Search.
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the ColumnFilterPopupMode property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.