PivotGridFieldFilterValues.ValuesIncluded Property

Gets or sets the values that are displayed in the current field.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.PivotGrid.v24.1.Core.dll

NuGet Packages: DevExpress.PivotGrid.Core, DevExpress.Win.Navigation

Declaration

C#

public object[] ValuesIncluded { get; set; }

VB.NET

Public Property ValuesIncluded As Object()

Property Value

Type	Description
Object[]	An array of the values that are displayed in the current field.

Remarks

This property returns an array of the values that are displayed in the current field by the XtraPivotGrid. To get the filter values use the PivotGridFieldFilterValues.Values property.

If an array of values is assigned to the ValuesIncluded property the current filter criteria will be reset and the XtraPivotGrid will then display the field values in this array for the current field. The other values will not be displayed. The following occur in this case:

1. the PivotGridFieldFilterValues.Values array is cleared
2. values from the source array are copied to the PivotGridFieldFilterValues.Values array
3. the PivotGridFieldFilterValues.FilterType property is set to PivotFilterType.Included.

If null is assigned the values in the PivotGridFieldFilterValues.Values array will be cleared. The result of the operation is dependant upon the value of the PivotGridFieldFilterValues.FilterType property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ValuesIncluded property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

wpf-pivot-grid-implement-a-custom-filter-popup/CS/DXPivotGrid_CustomFilterPopup/CustomFilterEdit.cs#L41

var uniqueItems = PivotField.GetUniqueValues().Select(v => new PivotValueInfo() { Value = v, DisplayText = PivotField.GetDisplayText(v) }).ToArray();
var editValue = PivotField.FilterValues.ValuesIncluded;
ItemsSource = uniqueItems;

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/CS/Report_at_Runtime/Form1.cs#L26

this.customerReportsTableAdapter.Fill(this.nwindDataSet.CustomerReports);
fieldProductName1.FilterValues.ValuesIncluded = fieldProductName1.GetUniqueValues().Take(7).ToArray();
pivotGridControl1.BestFit();

winforms-pivot-grid-sort-data-by-olap-member-properties/CS/WinFormsPivotGridCustomOLAPSort/Form1.cs#L18

fieldFiscalYear.FilterValues.FilterType = PivotFilterType.Included;
fieldFiscalYear.FilterValues.ValuesIncluded = new object[] { 2004, 2005 };
pivotGridControl1.BestFit();

VB.NET

wpf-pivot-grid-implement-a-custom-filter-popup/VB/DXPivotGrid_CustomFilterPopup/CustomFilterEdit.vb#L50

'INSTANT VB NOTE: The variable editValue was renamed since Visual Basic does not handle local variables named the same as class members well:
            Dim editValue_Renamed = PivotField.FilterValues.ValuesIncluded
            ItemsSource = uniqueItems

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/VB/Report_at_Runtime/Form1.vb#L28

customerReportsTableAdapter.Fill(nwindDataSet.CustomerReports)
fieldProductName1.FilterValues.ValuesIncluded = fieldProductName1.GetUniqueValues().Take(7).ToArray()
pivotGridControl1.BestFit()

winforms-pivot-grid-sort-data-by-olap-member-properties/VB/WinFormsPivotGridCustomOLAPSort/Form1.vb#L18

fieldFiscalYear.FilterValues.FilterType = PivotFilterType.Included
fieldFiscalYear.FilterValues.ValuesIncluded = New Object() {2004, 2005}
pivotGridControl1.BestFit()