TdxExcelFilterValueContainerApplyChangesMode Enum

Enumerates filter criteria update modes available for all Excel-inspired filter dropdowns.

Declaration

TdxExcelFilterValueContainerApplyChangesMode = (
    efacDefault,
    efacImmediately,
    efacOnTabOrOKButtonClick
);

Members

Name
efacDefault
efacImmediately
efacOnTabOrOKButtonClick

Remarks

Options include:

Value	Description	Example
efacDefault	A more global setting is in effect (for instance, an item uses its container control’s setting, or the control uses the global constant value, etc.) in the default filter criteria update mode. efacDefault and efacImmediately are equivalent when used as the dxDefaultExcelFilterValueContainerApplyChanges global constant’s values.
efacImmediately	Explicitly enables the immediate criteria update mode for an Excel-inspired filter dropdown. efacImmediately and efacDefault are equivalent when used as the dxDefaultExcelFilterValueContainerApplyChanges global constant’s values.
efacOnTabOrButtonClick	An Excel-inspired filter dropdown updates the filter criteria on demand and shows the OK button that confirms changes and closes the dropdown window. Alternatively, a user can switch to another page (tab) of the filter dropdown to apply all pending changes. This mode can be favorable for an application that shows and filters lots of data entries, since on-demand criteria update increases the filter dropdown’s UI responsiveness.

The following public API members reference the TdxExcelFilterValueContainerApplyChangesMode type:

• The dxDefaultExcelFilterValueContainerApplyChanges global constant.

• A container control item’s Properties.Options.ExcelFilterPopup.ApplyChanges property in vertical grid and tree list controls.

• The Options.FilteringExcelPopupApplyChanges property of a grid item in the TcxGrid control.

• The Filtering.ColumnExcelPopup.ApplyChanges property of a Table View in the TcxGrid control.

• The Filtering.RowExcelPopup.ApplyChanges property of a Card View in the TcxGrid control.