WindowsFormsSettings.ColumnFilterPopupMode Property

Gets or sets the default display mode of column filter dropdowns in all GridControls, TreeLists and PivotGridControls in the current application.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.Utils.v20.1.dll

Declaration

public static ColumnFilterPopupMode ColumnFilterPopupMode { get; set; }
Public Shared Property ColumnFilterPopupMode As ColumnFilterPopupMode

Property Value

Type Description
ColumnFilterPopupMode

A value that specifies the default display mode of column filter dropdowns in all GridControls and TreeLists in the current application.

Remarks

Column filter dropdowns (within the GridConrol and within the TreeList) 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 current static WindowsFormsSettings.ColumnFilterPopupMode property specifies the default column filter dropdown style for all GridControls and TreeLists in your application.

  2. Control level.

    For the GridControl, use a View's ColumnViewOptionsFilter.ColumnFilterPopupMode property (ColumnView.OptionsFilter.ColumnFilterPopupMode) to specify the default column filter dropdown style in this specific View.

    For the TreeList control, use the TreeListOptionsFilter.ColumnFilterPopupMode property (TreeList.OptionsFilter.ColumnFilterPopupMode).

    For the PivotGridControl control, use the PivotGridOptionsFilterPopup.FieldFilterPopupMode property (PivotGrid.OptionsFilterPopup.FieldFilterPopupMode).

    These control level settings override the WindowsFormsSettings.ColumnFilterPopupMode global setting for the current control.

  3. Column / field level.

    For the GridControl, use a column's OptionsColumnFilter.FilterPopupMode property (GridColumn.OptionsFilter.FilterPopupMode) to specify the filter dropdown style for this specific column.

    For the TreeList control, use a column's TreeListOptionsColumnFilter.FilterPopupMode property (TreeListColumn.OptionsFilter.FilterPopupMode).

    For the PivotGridControl control, use a field's PivotGridFieldOptionsEx.FieldFilterPopupMode property (PivotGridField.Options.FieldFilterPopupMode).

    The column level settings override the corresponding control level settings for the current column.

The WindowsFormsSettings.ColumnFilterPopupMode property can be set to one of the following values:

For more details on Excel-inspired filter dropdowns, see the GridControl's Excel Style Filter DropDown and TreeList's Excel Style Filter DropDown topics.

See Also