The Filter Editor enables end-users to build complex filter criteria with an unlimited number of filter conditions, combined by logical operators. The resulting filter condition will be combined with the field-based filter criteria using the AND Boolean operator. The Filter Editor provides a set of logical operators that significantly simplify the process of creating filters for text, numeric and date-time fields.
End-users can invoke the Filter Editor at runtime via a context menu.
To disable access to the Filter Editor via the context menu, set the PivotGridControl.AllowPrefilter property to false. In this instance, the Show Prefilter context menu item will be hidden, and you will be able to show the Filter Editor using the PivotGridControl.ShowPrefilter method.
When the PivotGridControl.AllowPrefilter option is enabled, and a filter condition is specified, PivotGridControl displays a Prefilter Panel:
The Prefilter Panel displays a filter expression, an MRU filter button used to display the most recently used Prefilter criteria, an edit button used to invoke a Filter Editor, a check box used to temporarily enable/disable the filtering, and a clear button used to reset the current filter condition. To make this panel always visible or always hidden, use the PivotGridControl.ShowPrefilterPanelMode property.
The Prefilter allows you to access its settings and specify filter criteria in code. You can use the following properties and methods to do this:
When you create a filter expression in code, use the PivotGridField.PrefilterColumnName property to refer to a field. The sample below shows how to do this.
| C# |
pivotGridControl1.PrefilterString = "[" + fieldCategory.PrefilterColumnName + "] Like 'B%'";
|
| VB |
pivotGridControl1.PrefilterString = "[" + fieldCategory.PrefilterColumnName + "] Like 'B%'"
|
NoteThe Prefilter cannot filter data against data fields. If a data field is used in filter criteria that has been specified in code, an error message will be displayed within the Prefilter Panel. This message also appears if filter criteria contains a field name that does not exist.
After a filter condition has been changed via a Filter Editor or in code, the PivotGridControl.PrefilterCriteriaChanged event is raised.
To learn more about filter criteria syntax, see Criteria Language Syntax.