TreeListOptionsFilter.ColumnFilterPopupMode Property

Gets or sets the default display mode of filter dropdowns for columns in the current TreeList.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.2.dll

Declaration

C#

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

VB.NET

<DefaultValue(ColumnFilterPopupMode.Default)>
<XtraSerializableProperty>
Public Property ColumnFilterPopupMode As ColumnFilterPopupMode

Property Value

Type	Default	Description
DevExpress.XtraTreeList.ColumnFilterPopupMode	**Default**	A value that specifies the default display mode of filter dropdowns for columns in the current TreeList.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ColumnFilterPopupMode
WinForms Controls	ResourcesTree	.OptionsFilter.ColumnFilterPopupMode
	TreeList	.OptionsFilter.ColumnFilterPopupMode
Reporting	XRDesignFieldList	.OptionsFilter.ColumnFilterPopupMode
	XRDesignReportExplorer	.OptionsFilter.ColumnFilterPopupMode

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.

1. Application level

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

2. Control level

   The current property (TreeList.OptionsFilter.ColumnFilterPopupMode) specifies the default column filter dropdown style in a certain TreeList. This setting overrides the WindowsFormsSettings.ColumnFilterPopupMode global setting.

3. Column level

   A column’s TreeListOptionsColumnFilter.FilterPopupMode property (TreeListColumn.OptionsFilter.FilterPopupMode) specifies the filter dropdown style for a specific column. This setting overrides the TreeList.OptionsFilter.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. If the global setting is also set to Default (which is used by default), the Classic mode is enabled.
• Classic - Sets classic display styles as default in the current TreeList. The classic presentation styles will be applied to columns that have the TreeListColumn.OptionsFilter.FilterPopupMode property set to Default. Otherwise, column filter dropdowns will be presented according to the TreeListOptionsColumnFilter.FilterPopupMode (TreeListColumn.OptionsFilter.FilterPopupMode) property.
• Excel - Sets the MS Excel-inspired filter dropdown style as default in the current TreeList. This presentation mode will be applied to columns that have the TreeListColumn.OptionsFilter.FilterPopupMode property set to Default. Otherwise, column filter dropdowns will be presented according to the TreeListColumn.OptionsFilter.FilterPopupMode property.

For more details on Excel-inspired filter dropdowns, see Pop-up Filter Menus.