Breaking Change T1071091
Visible to All Users

Pivot Grid control - The Prefilter API is hidden from IntelliSence and documentation

What Changed

The Prefilter's API became obsolete and was hidden from IntelliSense and documentation. Use the Filter Editor's API instead.

Reasons for Change

Pop-up filters do not synchronize their values with Prefilter values and display filters for a specific field only.

This change reduces possible confusion when you applied a filter both in the pop-up filter and Prefilter. The Filter Editor's API allows a user to synchronize filters applied in the pop-up filter and Filter Editor.

Impact on Existing Apps

This change affects WinForms, WPF, ASP.NET Web Forms, and ASP.NET MVC applications if you use the Prefilter's API.

How to Update Existing Apps

Refer to the table below to find a new API you can use instead of the Prefilter's API:

Platform Prefilter API New API
ASP.NET ASPxPivotGrid.Prefilter ASPxPivotGrid.Filter
ASP.NET ASPxPivotGrid.PrefilterCriteriaChanged ASPxPivotGrid.FilterCriteriaChanged
ASP.NET ASPxPivotGridPopupMenu.ShowPrefilterID ASPxPivotGridPopupMenu.ShowFilterEditorID
WinForms PivotGridAppearances.PrefilterPanel PivotGridAppearances.FilterPanel
WinForms PivotGridControl.Prefilter PivotGridControl.ActiveFilter
WinForms PivotGridControl.PrefilterCriteriaChanged PivotGridControl.ActiveFilterCriteriaChanged
WinForms PivotGridFieldOptions.ShowInPrefilter PivotGridFieldOptions.ShowInFilter
WPF PivotGridField.ShowInPrefilter PivotGridField.ShowInFilterEditor
WPF PivotGridControl.PrefilterCriteria PivotGridControl.FilterCriteria
WPF PivotGridControl.PrefilterString PivotGridControl.FilterString
WPF PivotGridControl.PrefilterControl PivotGridControl.FilterControl
WPF PivotGridControl.CanEnablePrefilter PivotGridControl.CanEnableFilter
WPF PivotGridControl.PrefilterPanelText PivotGridControl.FilterPanelText
WPF PivotGridControl.ShowPrefilterPanel PivotGridControl.ShowFilterPanel
WPF PivotGridControl.ShowPrefilterPanelMode PivotGridControl.ShowFilterPanelMode
WPF PivotGridControl.IsPrefilterEnabled PivotGridControl.IsFilterEnabled
WPF DefaultMenuItemNames.ShowPrefiler DefaultMenuItemNames.ShowFilterEditor
WPF DefaultMenuItemNames.HidePrefilter DefaultMenuItemNames.HideShowFilterEditorr
WPF PivotGridControl.ShowPrefilter PivotGridControl.ShowFilterEditor
WPF PivotGridControl.HidePrefilter PivotGridControl.HideFilterEditor
WPF PivotGridControl.ResetPrefilter PivotGridControl.ResetFilterCriteria
Core PivotGridFieldBase.PrefilterColumnName PivotGridFieldBase.FilterColumnName
Core PivotGridFieldOptions.ShowInPrefilter PivotGridFieldOptions.ShowInFilter
Core PivotGridOptionsCustomization.AllowPrefilter PivotGridOptionsCustomization.AllowFilter
Core PivotGridStringId.PopupMenuShowPrefilter PivotGridStringId.PopupMenuShowFilter
Core PivotGridStringId.PopupMenuHidePrefilter PivotGridStringId.PopupMenuHideFilter
Core PivotGridStringId.PrefilterInvalidCriteria PivotGridStringId.FilterInvalidCriteria
Core PivotGridStringId.PrefilterFormCaption PivotGridStringId.FilterFormCaption
Core PivotGridStringId.EditPrefilter PivotGridStringId.EditFilter

How to Revert to Previous Behavior

You can use the Prefilter API if necessary.

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.