Skip to main content
A newer version of this page is available. .

TreeListOptionsColumnFilter.FilterPopupMode Property

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

Namespace: DevExpress.XtraTreeList.Columns

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

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

Property Value

Type Default Description
FilterPopupMode **Default**

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

Available values:

Name Description
Default

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

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

  • for columns displaying date-time values, this option is equivalent to the Date option;
  • for other columns, this option is equivalent to the List option.

If the TreeList’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.

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 control will display those records that contain the checked values.

Date

This mode is in effect for columns displaying date-time values. The filter dropdown contains a calendar, plus check boxes that allow used date intervals to be selected. If there is no underlying data that would fall into a specific date range, the corresponding check box is hidden.

Excel

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

Property Paths

You can access this nested property as listed below:

Object Type Path to FilterPopupMode
TreeListColumn
.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

See the FilterPopupMode topic, for a description of the available display modes.

See Also