Documentation – Add Pivot Table Row and Column Fields in Aspose.Cells for Go via C++

Gocpp: Filtering Pivot Tables by Label or Value

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells provides five practical strategies for filtering the data displayed in a pivot table. You can apply label filters to text-based row or column fields, use date filters when the field contains only date-time cells or blanks, apply value filters against aggregated numbers, use top 10 filters to rank by a value field, or manually hide and unhide individual pivot items using the IsHidden property. Each strategy is exposed through dedicated APIs on the PivotField and PivotItem classes.

Introduction

Pivot tables are powerful analytical tools, but raw summaries often contain far more information than you need to present. Filtering is the primary mechanism for narrowing a pivot table down to the rows, columns, or values that matter for a specific report. Aspose.Cells for Go via C++ mirrors the filtering capabilities that are available in Microsoft Excel, exposing them programmatically so that report generation can be fully automated. The following filtering strategies are covered in this article:

Label Filter — filters row or column field items based on their text labels.
Date Filter — filters row or column fields that contain only date-time values (or blanks).
Value Filter — filters items based on the aggregated values of a data field.
Top 10 Filter — shows only the top or bottom N items ranked by a value field.
Hide / Unhide Pivot Items — manually controls the visibility of each individual item in a field. Each approach uses a different method on the PivotField class or a property on the PivotItem class. After applying any filter, you must call RefreshData() and CalculateData() on the pivot table so that the cached data and calculated values reflect the new filter state.

Label Filter

A label filter allows you to filter the items of a row or column field by comparing their text captions against a pattern. This is useful when you want to display only products whose names start with a specific letter, contain a particular word, or match some other caption-based criterion. Aspose.Cells exposes label filtering through the PivotField.FilterByLabel(PivotFilterType, const char16_t*) method. The PivotFilterType enumeration includes values such as CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank, and so on. The second argument supplies the label string used for comparison. The following example loads a workbook containing an existing pivot table, applies a label filter so that only items whose captions begin with a specified prefix remain visible, refreshes the pivot table, and saves the result.

Date Filter

Date filters let you narrow a pivot table by date-based criteria such as today, last week, this month, next quarter, or a specific date range. They are specialized filters that work only against fields that store date-time information.

The date filter only works when the row or column area contains only date-time cells or blank values. If the underlying field contains other data types such as numbers or text, the date filter will not produce the expected result. Make sure the field is formatted as a date and that all values are valid DateTime instances or empty cells before applying this filter.

Aspose.Cells exposes date filtering through the PivotField.FilterByDate(PivotFilterType, const Vector<DateTime>& values) method. The PivotFilterType enumeration contains dedicated date values such as Today, Yesterday, LastWeek, ThisWeek, NextWeek, LastMonth, ThisMonth, NextMonth, LastQuarter, ThisQuarter, NextQuarter, LastYear, ThisYear, NextYear, and Between. Depending on the chosen filter type, you pass one or two DateTime values (for Between, you pass the start and end dates). The following example loads a workbook with a pivot table whose row area contains a date field, applies a date filter that restricts the visible items to a particular date range, refreshes the pivot table, and saves the workbook.

Value Filter

Value filters operate on the aggregated values that a pivot table calculates in its data area. Instead of matching text labels, they compare numeric totals against a threshold. Typical use cases include showing only products whose sum of sales exceeds a target amount or only regions whose count of transactions falls within a range. Aspose.Cells exposes value filtering through the PivotField.FilterByValue(PivotField valueField, PivotFilterType filterType, const Vector<Variant>& values) method. The filterType parameter uses values such as ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual, and ValueLessThanOrEqual. The valueField parameter specifies which data field should be evaluated, and the final argument(s) supply the threshold value(s). The following example loads a workbook with a pivot table, applies a value filter that keeps only items whose aggregated sales exceed a numeric threshold, refreshes the pivot table, and saves the workbook.

Top 10 Filter

The top 10 filter is a specialized form of value filter that retains only the highest or lowest N items based on a chosen value field. It is commonly used for ranking reports such as “top 10 products by revenue” or “bottom 5 regions by sales count”.

The top 10 filter is only effective when the pivot table has one or more value pivot fields in the data area. Without at least one value field, there is no aggregated measure to rank the items against, and the filter cannot be applied.

Aspose.Cells exposes top 10 filtering through the PivotField.FilterTop10(int32_t itemCount, bool isTop, PivotField valueField, PivotFilterType filterType) method. The itemCount parameter defines how many items to retain, isTop indicates whether to keep the top items (true) or the bottom items (false), valueField references the data field used for ranking, and filterType controls how the value is computed (typically Sum, but also Count and Percent). The following example loads a workbook with a pivot table that contains a value field, applies a top 10 filter to keep only the highest 10 items by the sum of sales, refreshes the pivot table, and saves the workbook.

Filter by Hiding or Unhiding Pivot Items

In addition to the structured filter APIs, Aspose.Cells allows you to control the visibility of each individual pivot item directly. By iterating through the PivotItems collection of a PivotField and toggling the IsHidden property, you can selectively suppress specific items without applying a formula-based filter. Setting IsHidden = true hides the item from the pivot table; setting IsHidden = false unhides it and makes it visible again. This approach is useful when the filtering rule is irregular or item-specific, such as hiding a small number of named categories that should not appear in a particular report. The example below loads a pivot table, hides a specific item by name, demonstrates how to unhide it, refreshes the pivot table, and saves the workbook.

Summary

Aspose.Cells for Go via C++ provides a complete set of pivot table filtering capabilities that match those found in Microsoft Excel. Label, date, and value filters cover the most common analytical scenarios, while the top 10 filter handles ranking reports. When the filtering rule is irregular, the PivotItem.IsHidden property offers a flexible, item-level fallback. Combining these strategies — for example, applying a label filter and then hiding specific items — allows you to build precisely targeted pivot table reports entirely from code.

Gocpp: Specifying the Absolute Position of the Pivot Item with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Sometimes, users need to specify the absolute position of the pivot items. Aspose.Cells API has exposed a few new properties and a method to achieve this requirement.

Added PivotItem.GetPosition() property that can be used to specify the position index in all PivotItems, regardless of the parent node. Added PivotItem.GetPositionInSameParentNode() property that can be used to specify the position index in the PivotItems under the same parent node.
Added PivotItem.Move(int count, bool isSameParent) method in order to move the item up or down based on the count value, where count is the number of positions to move the PivotItem up or down. If the count value is less than zero, the item will be moved up, whereas if the count value is larger than zero, the PivotItem will move down. The Boolean‑type isSameParent parameter specifies whether the moving operation should be performed in the same parent node.
Obsoleted the PivotItem.Move(int count) method; therefore, it is suggested to use the newly added method PivotItem.Move(int count, bool isSameParent) instead.

The following sample code creates a Pivot Table and then specifies the positions of the Pivot Items in the same parent node. You can download the source Excel and output Excel files for your reference. If you open the output Excel file, you will see the Pivot Item “4H12” is at the 0th position in parent “K11”, and “DIF400” is at the 3rd position. Similarly, CA32 is at position 1 and AAA3 is at position 2.

Please note that it is necessary to call the PivotTable.RefreshData and PivotTable.CalculateData methods before using PivotItem.GetPosition(), PivotItem.GetPositionInSameParentNode() properties, and the PivotItem.Move(int count, bool isSameParent) method.

Gocpp: Get the Cell Object by DisplayName of PivotField of PivotTable with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells provides the PivotTable::GetCellByDisplayName() method, which you can use to access the cell object by the display name of a pivot field. This method is useful when you want to highlight or format your pivot field header. This article explains how to retrieve the cell object by the display name of a data field and then apply formatting to it.

Get the Cell Object by DisplayName of PivotField of PivotTable

The following code accesses the first pivot table of the worksheet and then retrieves the cell by the display name of the first data field of the pivot table. It then changes the fill color and font color of the cell to light blue and black, respectively. Below are screenshots showing how the pivot table looks before and after the execution of the code.

Pivot Table - Before

Pivot Table - After

Gocpp: Group Pivot Fields in the Pivot Table with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Possible Usage Scenarios

Microsoft Excel allows you to group pivot fields in the pivot table. When there is a large amount of data related to a pivot field, it is often useful to group them into sections. Aspose.Cells also provides this feature using the PivotTable.GroupBy() method.

Group Pivot Fields in the Pivot Table

The following sample code loads the sample Excel file and performs grouping on the first pivot field using the PivotTable.GroupBy() method. It then refreshes the pivot table, calculates its data, and saves the workbook as output Excel file. The screenshot shows the effect of the sample code on the sample Excel file. As you can see in the screenshot, the first pivot field is now grouped by months and quarters.

Sample Code

Gocpp: Pivot Table Hide and Sort Data with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Pivot Table Hide and Sort Data

Aspose.Cells supports hiding and sorting data in pivot tables. The following code snippet demonstrates this feature by sorting the score column in descending order and then hiding the rows with a score less than 60.

The source and output Excel files used in the code snippet are attached for reference.

Source File

Output File

Gocpp: Custom sorting in Pivot Table with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Custom sorting in Pivot Table

By using the Aspose.Cells API, you can sort Pivot Tables on field values. The following code snippet loads the sample Excel file and adds three pivot tables. The first pivot table does not use custom sorting, the second pivot table is sorted on “Seafood” row field values, and the third pivot table is sorted on “28/07/2000” column field values.

Sample source file and output files can be downloaded from here for testing the sample code:

Source Excel File

Output Excel File

Output PDF File

Gocpp: Pivot Filter with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Possible Usage Scenarios

When you create a pivot table with known data and want to filter the pivot table, you need to learn and use a filter. It can help you filter out the data you want effectively. By using the Aspose.Cells API, you can add and clear filters on field values in Pivot Tables.

Add Filter in Pivot Table in Excel

Add a filter in a Pivot Table in Excel, follow these steps:

Select the PivotTable that you want to add a filter to.
Click on the drop‑down arrow for the filter you want to add in the pivot table.
Select Top 10 from the drop‑down menu.
Set the show mode and the number of items.

Add Filter in Pivot Table

Please see the following sample code. It sets the data and creates a PivotTable based on it. Then it adds a filter on the row field of the pivot table. Finally, it saves the workbook in the output XLSX format. After executing the example code, a pivot table with a Top 10 filter is added to the worksheet.

Sample Code

Clear Filter in Pivot Table in Excel

Clear a filter in a Pivot Table in Excel, follow these steps:

Select the PivotTable that you want to clear the filter from.
Click on the drop‑down arrow for the filter you want to clear in the pivot table.
Select Clear Filter from the drop‑down menu.
If you want to clear all filters from the pivot table, you can also click the Clear Filters button on the PivotTable Analyze tab of the ribbon in Excel.

Clear Filter in Pivot Table

Clear a filter in a Pivot Table using Aspose.Cells. Please see the following sample code.

Set the data and create a PivotTable based on it.
Add a filter on the row field of the pivot table.
Save the workbook in the output XLSX format. After executing the example code, a pivot table with a Top 10 filter is added to the worksheet.
Clear the filter on a specific PivotField. After executing the code to clear the filter, the filter on the specific PivotField will be removed. Please check the output XLSX.

Documentation – Add Pivot Table Row and Column Fields in Aspose.Cells for Go via C++

Gocpp: Filtering Pivot Tables by Label or Value

Introduction

Label Filter

Date Filter

Value Filter

Top 10 Filter

Filter by Hiding or Unhiding Pivot Items

Summary

Related Articles

Gocpp: Specifying the Absolute Position of the Pivot Item with Golang via C++

Gocpp: Get the Cell Object by DisplayName of PivotField of PivotTable with Golang via C++

Get the Cell Object by DisplayName of PivotField of PivotTable

Gocpp: Group Pivot Fields in the Pivot Table with Golang via C++

Possible Usage Scenarios

Group Pivot Fields in the Pivot Table

Sample Code

Gocpp: Pivot Table Hide and Sort Data with Golang via C++

Pivot Table Hide and Sort Data

Gocpp: Custom sorting in Pivot Table with Golang via C++

Custom sorting in Pivot Table

Gocpp: Pivot Filter with Golang via C++

Possible Usage Scenarios

Add Filter in Pivot Table in Excel

Add Filter in Pivot Table

Sample Code

Clear Filter in Pivot Table in Excel

Clear Filter in Pivot Table

Sample Code