A newer version of this page is available. Switch to the current version.

OptionsColumnFilter.FilterPopupMode Property

Gets or sets display mode for the column’s filter dropdown.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

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

Property Value

Type Default Description
FilterPopupMode

Default

A FilterPopupMode value that specifies display mode for the column’s filter dropdown.

Available values:

Name Description
Default

The actual display mode is determined by the View’s OptionsFilter.ColumnFilterPopupMode (ColumnViewOptionsFilter.ColumnFilterPopupMode) property.

If the View’s OptionsFilter.ColumnFilterPopupMode property is set to Classic:

  • for date-time columns, filter dropdowns are painted in FilterPopupMode.DateSmart mode;
  • for all other columns, filter dropdowns are painted in FilterPopupMode.List mode.

If the View’s OptionsFilter.ColumnFilterPopupMode property is set to Default (which is the initial value):

If the WindowsFormsSettings.ColumnFilterPopupMode property is also set to Default (which is the initial value):

  • the Excel filter dropdown style is applied.
List

The filter dropdown is represented as a regular list of filter items. Clicking an item invokes a corresponding action, and automatically closes the dropdown.

FilterDropDown_List

CheckedList

The filter dropdown is represented as a checked list of filter items. In this mode, an end-user can select more than one item simultaneously. When the dropdown window is closed by clicking the OK button, the View will display those records that contain the checked values:

FilterDropDown_CheckedList

Date

This mode is equivalent to DateSmart regarding the appearance of the filter dropdown. The filter dropdown displays all the available check boxes, even if there is no data that falls into a corresponding date range.

DateSmart

The filter dropdown provides a built-in calendar plus check boxes to select common non-intersecting date intervals.

CalendarFilterDropdown-Date

The table below describes the available date ranges for the DateSmart and Date modes.

Interval Description
Beyond this year Dates that follow the current year.
Later this year Dates of the current year starting from the following month.
Later this month Dates of the current month that follow the next week.
Next week Dates that belong to the following week.
Later this week Dates of the current week starting from the day after tomorrow.
Tomorrow Tomorrow.
Today Today.
Yesterday Yesterday.
Earlier this week Dates of the current week that are prior to yesterday.
Last week Dates of the previous week.
Earlier this year Dates of the current year that are prior to the current month.
Prior to this year Dates that are prior to the current year.

If there is no underlying data that would fall into a specific date range, the corresponding check box is hidden.

If all values in the date-time column are set to null, all check boxes are visible.

DateAlt

This mode is equivalent to DateSmart, but with a different set of filters: Today, This week, This month, Next month, etc.

CalendarFilterDropdown-DateAlt.png

The table below describes several of the date ranges for the DateAlt mode.

Interval Description
Beyond Dates that belong to the month in three months time and beyond.
Earlier Dates that belong to the month seven months ago and earlier.
Excel

The tabbed UI, inspired by MS Excel, that displays column values and provides filtering options most suitable for the column’s data type.

GridExcelFilter_DateFilters_Values

Property Paths

You can access this nested property as listed below:

Object Type Path to FilterPopupMode
GridColumn
.OptionsFilter.FilterPopupMode
LayoutViewColumn
.OptionsFilter.FilterPopupMode
BandedGridColumn
.OptionsFilter.FilterPopupMode

Remarks

Column filter dropdowns can be presented using the following display modes:

  • 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.

  1. Application level

    The static WindowsFormsSettings.ColumnFilterPopupMode property specifies the default column filter dropdown style for all GridControls in your application.

  2. Control level

    A View’s ColumnViewOptionsFilter.ColumnFilterPopupMode property (ColumnView.OptionsFilter.ColumnFilterPopupMode) specifies the default column filter dropdown style in a certain View. This setting overrides the WindowsFormsSettings.ColumnFilterPopupMode global setting.

  3. Column level

    The current GridColumn.OptionsFilter.FilterPopupMode property specifies the filter dropdown style for a specific column. This setting overrides the ColumnView.OptionsFilter.ColumnFilterPopupMode setting.

NOTE

If you handle any events from the list below, Data Grid switches from Excel-style filters to classic filtering menus. In this case, set the FilterPopupMode property to Excel explicitly in case you wish to continue using Excel filters.

See Also