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.