Documentation – 在 Aspose.Cells for C++ 中添加数据透视表的行字段和列字段

Cpp: 按标签或值筛选数据透视表

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

Aspose.Cells 提供了五种实用的策略来筛选数据透视表中显示的数据。您可以对基于文本的行或列字段应用标签筛选，在字段仅包含日期时间单元格或空值时使用日期筛选，对聚合数值应用值筛选，使用前 10 筛选按值字段排序，或者通过 IsHidden 属性手动隐藏和显示各个数据透视项。每种策略都通过 PivotField 和 PivotItem 类上专门的 API 来实现。

简介

数据透视表是强大的分析工具，但原始汇总通常包含比您需要展示的信息多得多的内容。筛选是缩小数据透视表范围、只保留特定报告所需的行、列或值的主要机制。Aspose.Cells for C++ 完全镜像了 Microsoft Excel 中提供的筛选功能，并将其以编程方式公开，从而可以完全自动化报告生成过程。本文涵盖以下筛选策略：

标签筛选 — 根据文本标签筛选行或列字段项。
日期筛选 — 筛选仅包含日期时间值（或空值）的行或列字段。
值筛选 — 根据数据字段的聚合值筛选项。
前 10 筛选 — 仅显示按值字段排序的前 N 项或后 N 项。
隐藏/显示数据透视项 — 手动控制字段中每个单独项的可见性。每种方法都使用 PivotField 类上的不同方法或 PivotItem 类上的属性。应用任何筛选后，必须在数据透视表上调用 RefreshData() 和 CalculateData()，以便缓存数据和计算值反映新的筛选状态。

标签筛选

标签筛选允许您通过将行或列字段项的文本标题与模式进行比较来筛选这些项。当您只想显示名称以特定字母开头、包含特定单词或符合其他基于标题条件的项时，此功能非常有用。 Aspose.Cells 通过 PivotField.FilterByLabel(PivotFilterType, const char16_t*) 方法公开标签筛选功能。PivotFilterType 枚举包含以下值：CaptionBeginsWith、CaptionContains、CaptionEndsWith、CaptionDoesNotContain、CaptionIsNotBlank、CaptionIsBlank 等。第二个参数提供用于比较的标签字符串。下面的示例加载包含现有数据透视表的工作簿，应用标签筛选使只有标题以指定前缀开头的项可见，刷新数据透视表，并保存结果。

#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    U16String fileName(u"sample.xlsx");
    U16String prefix(u"B");

    // 加载包含数据透视表的现有工作簿
    Workbook wb(fileName);

    // 通过索引访问工作表（第一个工作表）
    Worksheet ws = wb.GetWorksheets().Get(0);

    // 通过索引访问数据透视表
    PivotTable pt = ws.GetPivotTables().Get(0);

    // 检索第一个行透视字段
    PivotField rowField = pt.GetRowFields().Get(0);

    // 应用标签筛选器 —— 仅显示标签以所提供前缀开头的行项
    rowField.FilterByLabel(PivotFilterType::CaptionBeginsWith, prefix, U16String(u""));

    // 刷新并重新计算数据透视表数据，使筛选器生效
    pt.RefreshData();

    // 将工作簿保存回磁盘
    wb.Save(fileName);

    Aspose::Cells::Cleanup();
    return 0;
}

日期筛选

日期筛选允许您根据基于日期的条件（如今天、上周、本月、下个季度或特定日期范围）来缩小数据透视表的范围。它们是专用筛选，仅对存储日期时间信息的字段有效。

日期筛选仅在行区域或列区域仅包含日期时间单元格或空值时才有效。如果底层字段包含其他数据类型（如数字或文本），日期筛选将无法产生预期结果。在应用此筛选之前，请确保字段格式设置为日期，并且所有值都是有效的 DateTime 实例或空单元格。

Aspose.Cells 通过 PivotField.FilterByDate(PivotFilterType, const Vector<DateTime>& values) 方法公开日期筛选功能。PivotFilterType 枚举包含专门的日期值，例如 Today、Yesterday、LastWeek、ThisWeek、NextWeek、LastMonth、ThisMonth、NextMonth、LastQuarter、ThisQuarter、NextQuarter、LastYear、ThisYear、NextYear 和 Between。根据所选的筛选类型，您传入一个或两个 DateTime 值（对于 Between，传入起始日期和结束日期）。下面的示例加载一个数据透视表的行区域中包含日期字段的工作簿，应用日期筛选将可见项限制在特定日期范围内，刷新数据透视表，并保存工作簿。

#include "Aspose.Cells.h"
#include <string>
#include <filesystem>

using namespace Aspose::Cells;
using namespace Aspose::Cells::Pivot;

int main() {
    Aspose::Cells::Startup();

    std::string inputPath = "sample.xlsx";
    std::string outputPath = "output_filtered.xlsx";

    if (!std::filesystem::exists(inputPath))
    {
        // 未找到源工作簿。
        Aspose::Cells::Cleanup();
        return -1;
    }

    // 加载包含数据透视表的现有工作簿
    Workbook workbook(U16String(inputPath.c_str()));

    // 通过索引访问包含数据透视表的工作表
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // 通过索引访问数据透视表
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    // 从行区域获取日期透视字段
    PivotField dateField = pivotTable.GetRowFields().Get(0);

    // 定义 Between 筛选器的日期条件
    Date startDate{2020, 1, 1, 0, 0, 0, 0};
    Date endDate{2020, 12, 31, 0, 0, 0, 0};

    // 在透视字段上应用日期筛选器
    dateField.FilterByDate(PivotFilterType::DateBetween, startDate, endDate);

    // 刷新并重新计算数据透视表以使筛选器生效
    // 保存工作簿
    workbook.Save(U16String(outputPath.c_str()));

    Aspose::Cells::Cleanup();
    return 0;
}

值筛选

值筛选对数据透视表在数据区域中计算的聚合值进行操作。它们不匹配文本标签，而是将数值总数与阈值进行比较。典型用例包括仅显示销售总额超过目标金额的产品，或仅显示交易计数在某个范围内的区域。 Aspose.Cells 通过 PivotField.FilterByValue(PivotField valueField, PivotFilterType filterType, const Vector<Variant>& values) 方法公开值筛选功能。filterType 参数使用以下值：ValueGreaterThan、ValueLessThan、ValueBetween、ValueEqual、ValueNotEqual、ValueGreaterThanOrEqual 和 ValueLessThanOrEqual。valueField 参数指定应评估哪个数据字段，最后一个参数（或多个参数）提供阈值。下面的示例加载一个包含数据透视表的工作簿，应用值筛选仅保留聚合销售额超过数值阈值的项，刷新数据透视表，并保存工作簿。

#include "Aspose.Cells.h"
#include <cfloat>

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    Workbook wb(u"sample.xlsx");
    Worksheet worksheet = wb.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    PivotField rowField = pivotTable.GetRowFields().Get(0);
    PivotField dataField = pivotTable.GetDataFields().Get(0);

    int dataFieldIndex = -1;
    int dataFieldCount = pivotTable.GetDataFields().GetCount();
    for (int i = 0; i < dataFieldCount; i++)
    {
        PivotField current = pivotTable.GetDataFields().Get(i);
        if (current.GetName() == dataField.GetName())
        {
            dataFieldIndex = i;
            break;
        }
    }

    if (dataFieldIndex >= 0)
    {
        rowField.FilterByValue(dataFieldIndex, PivotFilterType::ValueGreaterThan, 5000, DBL_MAX);
    }

    wb.Save(u"output.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

前 10 筛选

前 10 筛选是值筛选的一种专用形式，仅保留基于所选值字段的最高或最低 N 项。它通常用于排名报告，例如"按收入排名的前 10 个产品"或"按销售数量排名的后 5 个区域"。

前 10 筛选仅在数据透视表的数据区域中具有一个或多个值数据透视字段时才有效。如果没有至少一个值字段，则没有可用来对项进行排名的聚合度量，筛选将无法应用。

Aspose.Cells 通过 PivotField.FilterTop10(int32_t itemCount, bool isTop, PivotField valueField, PivotFilterType filterType) 方法公开前 10 筛选功能。itemCount 参数定义要保留的项数，isTop 指示是保留顶部项（true）还是底部项（false），valueField 引用用于排名的数据字段，filterType 控制如何计算值（通常为 Sum，也可以是 Count 和 Percent）。下面的示例加载一个包含具有值字段的数据透视表的工作簿，应用前 10 筛选仅保留按销售额总和排名的最高 10 项，刷新数据透视表，并保存工作簿。

#include "Aspose.Cells.h"
#include <stdexcept>

using namespace Aspose::Cells;
using namespace Aspose::Cells::Pivot;

int main() {
    Aspose::Cells::Startup();

    U16String inputPath(u"input.xlsx");
    U16String outputPath(u"output.xlsx");

    Workbook workbook(inputPath);

    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    if (pivotTable.GetDataFields().GetCount() == 0) {
        throw std::runtime_error("Pivot table has no value (data) PivotField.");
    }

    PivotField valueField = pivotTable.GetDataFields().Get(0);
    PivotField rowField = pivotTable.GetRowFields().Get(0);

    int valueFieldIndex = 0;

    rowField.FilterTop10(10, PivotFilterType::Sum, true, valueFieldIndex);

    workbook.Save(outputPath);

    Aspose::Cells::Cleanup();
    return 0;
}

通过隐藏或显示数据透视项进行筛选

除了结构化的筛选 API 外，Aspose.Cells 还允许您直接控制每个单独数据透视项的可见性。通过遍历 PivotField 的 PivotItems 集合并切换 IsHidden 属性，您可以选择性地隐藏特定项，而无需应用基于公式的筛选。设置 IsHidden = true 会从数据透视表中隐藏该项；设置 IsHidden = false 会取消隐藏并使其再次可见。当筛选规则不规则或特定于项时，此方法非常有用，例如隐藏不应出现在特定报告中的少量命名类别。下面的示例加载一个数据透视表，按名称隐藏特定项，演示如何取消隐藏它，刷新数据透视表，并保存工作簿。

#include "Aspose.Cells.h"
#include <string>

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    // 加载包含数据透视表的现有工作簿
    Workbook workbook(u"pivot_table_sample.xlsx");

    // 访问包含数据透视表的第一个工作表
    Worksheet sheet = workbook.GetWorksheets().Get(0);

    // 通过索引访问数据透视表（工作表上的第一个数据透视表）
    PivotTable pivotTable = sheet.GetPivotTables().Get(0);

    // 检索目标 PivotField（我们将在其中隐藏/显示项目的第一行标签字段）
    PivotField pivotField = pivotTable.GetRowFields().Get(0);

    // 遍历所选 PivotField 的 PivotItems 集合
    int itemCount = pivotField.GetPivotItems().GetCount();
    for (int i = 0; i < itemCount; i++)
    {
        PivotItem item = pivotField.GetPivotItems().Get(i);

        U16String name = item.GetName();
        std::string nameStr = name.ToUtf8();

        // 隐藏符合特定名称/条件的数据透视表项
        if (nameStr == "Item1" || nameStr == "Item2")
        {
            item.SetIsHidden(true);
        }

        // 演示取消隐藏：重新显示之前隐藏的数据透视表项
        if (nameStr == "Item3")
        {
            item.SetIsHidden(false);
        }
    }

    // 刷新并重新计算数据透视表以使更改生效
    pivotTable.CalculateData();

    // 保存工作簿 — 隐藏的项目保留在底层数据中
    // 但从显示的数据透视表输出中排除
    workbook.Save(u"output_pivot_filtered.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

总结

Aspose.Cells for C++ 提供了一整套与 Microsoft Excel 中所提供的数据透视表筛选功能相匹配的功能。标签筛选、日期筛选和值筛选涵盖了最常见的分析场景，而前 10 筛选处理排名报告。当筛选规则不规则时，PivotItem.IsHidden 属性提供了一种灵活的、项级别的备用方案。结合这些策略——例如先应用标签筛选然后隐藏特定项——您可以完全从代码构建精准定位的数据透视表报告。

Cpp: 用C++指定数据透视项的绝对位置

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

有时，用户需要指定数据透视项的绝对位置。Aspose.Cells API引入了几项新属性和一个方法来实现此需求。

添加了PivotItem.GetPosition()属性，可用于指定所有数据透视项的位置索引，而不论父节点如何。添加了PivotItem.GetPositionInSameParentNode()属性，可用于指定在同一父节点下的数据透视项的位置索引。
增加了 PivotItem.Move(int count, bool isSameParent) 方法，用于根据计数值上移或下移项目，其中计数代表移动的位置数。如果计数值小于零，则项目上移；如果大于零，则下移。布尔类型的 isSameParent 参数表示是否在同一父节点中进行移动操作。
淘汰了 PivotItem.Move(int count) 方法；建议使用新添加的 PivotItem.Move(int count, bool isSameParent) 方法。

以下示例代码创建了一个数据透视表，并在同一父节点内指定了数据透视项的位置。您可以下载源Excel和输出Excel文件以供参考。打开输出Excel文件后，您会看到数据透视项“4H12”位于父节点“K11”的第0位，“DIF400”位于第3位，类似的，CA32在第1位，AAA3在第2位。

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create workbook
    Workbook wb(srcDir + u"source.xlsx");

    // Add new worksheet for pivot table
    WorksheetCollection worksheets = wb.GetWorksheets();
    Worksheet wsPivot = worksheets.Add(u"pvtNew Hardware");
    Worksheet wsData = worksheets.Get(u"New Hardware - Yearly");

    // Get the pivot tables collection for the pivot sheet
    PivotTableCollection pivotTables = wsPivot.GetPivotTables();

    // Add PivotTable to the worksheet
    int index = pivotTables.Add(u"='New Hardware - Yearly'!A1:D621", u"A3", u"HWCounts_PivotTable");

    // Get the PivotTable object
    PivotTable pvtTable = pivotTables.Get(index);

    // Add vendor row field
    pvtTable.AddFieldToArea(PivotFieldType::Row, u"Vendor");

    // Add item row field
    pvtTable.AddFieldToArea(PivotFieldType::Row, u"Item");

    // Add data field
    pvtTable.AddFieldToArea(PivotFieldType::Data, u"2014");

    // Turn off the subtotals for the vendor row field
    PivotField pivotField = pvtTable.GetRowFields().Get(u"Vendor");
    pivotField.SetSubtotals(PivotFieldSubtotalType::None, true);

    // Turn off grand total
    pvtTable.SetShowColumnGrandTotals(false);

    // Refresh and calculate data before modifying pivot items
    pvtTable.CalculateData();

    // Set positions for specific pivot items
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"4H12").SetPositionInSameParentNode(0);
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"DIF400").SetPositionInSameParentNode(3);

    // Recalculate data after modifying pivot items
    pvtTable.CalculateData();

    // Set positions for additional pivot items
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"CA32").SetPositionInSameParentNode(1);
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"AAA3").SetPositionInSameParentNode(2);

    // Save the workbook
    wb.Save(outDir + u"output_out.xlsx");

    Aspose::Cells::Cleanup();
}

请注意，在使用 PivotItem.GetPosition()、PivotItem.GetPositionInSameParentNode() 属性和 PivotItem.Move(int count, bool isSameParent) 方法之前，必须调用 PivotTable.RefreshData 和 PivotTable.CalculateData 方法。

Cpp: 通过数据透视表的 PivotField 的显示名称获取单元格对象（C++）

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

Aspose.Cells 提供了 PivotTable::GetCellByDisplayName() 方法，可以通过数据透视字段的显示名称访问单元格对象。此方法在需要突出显示或格式化数据透视表标题时非常有用。本文详细介绍了如何通过数据字段的显示名称检索单元格对象，然后进行格式化。

用 C++ 通过数据透视表的 PivotField 的显示名称获取单元格对象

以下代码访问工作表的第一个数据透视表，并根据数据透视表的第二个数据字段的显示名称检索单元格。然后，将单元格的填充颜色设为浅蓝色，字体颜色设为黑色。以下为执行前后数据透视表的效果截图。

透视表 - 在之前

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    Workbook workbook(srcDir + u"source.xlsx");
    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    Cell cell = pivotTable.GetCellByDisplayName(pivotTable.GetDataFields().Get(0).GetDisplayName());

    Style style = cell.GetStyle();
    style.SetForegroundColor(Color::LightBlue());
    style.GetFont().SetColor(Color::Black());

    pivotTable.Format(cell.GetRow(), cell.GetColumn(), style);
    workbook.Save(outDir + u"output_out.xlsx");

    std::cout << "Pivot table formatted successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

透视表 - 在之后

Cpp: 用 C++ 在数据透视表中分组字段

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

可能的使用场景

Microsoft Excel允许您对透视表的透视字段进行分组。当与透视字段相关的数据量很大时，通常将它们分组成部分很有用。Aspose.Cells也提供使用PivotTable.GroupBy()方法的此功能。

在透视表中对透视字段进行分组

以下示例代码加载示例Excel文件，并使用PivotTable.GroupBy()方法对第一个透视字段执行分组。然后刷新和计算透视表的数据，并将工作簿保存为输出Excel文件。屏幕截图显示了示例代码对示例Excel文件的效果。如屏幕截图所示，第一个透视字段现在按月份和季度分组。

示例代码

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
	Aspose::Cells::Startup();

	U16String srcDir(u"../Data/01_SourceDirectory/");
	U16String outDir(u"../Data/02_OutputDirectory/");

	Workbook wb(srcDir + u"sampleGroupPivotFieldsInPivotTable.xlsx");

	Worksheet ws = wb.GetWorksheets().Get(1);

	PivotTable pt = ws.GetPivotTables().Get(0);

	Date dtStart{ 2023, 12, 31, 0, 0, 0, 0 };
	Date dtEnd{ 2025, 9, 5 , 0, 0, 0, 0 };

	Vector<PivotGroupByType> groupTypeList{
		 PivotGroupByType::Months,
		 PivotGroupByType::Quarters
	};

	PivotField field = pt.GetRowFields().Get(0);
	field.GroupBy(dtStart, dtEnd, groupTypeList, 1, true);

	pt.RefreshData();
	pt.CalculateData();

	wb.Save(outDir + u"outputGroupPivotFieldsInPivotTable2.xlsx");

	std::cout << "Pivot field grouped successfully." << std::endl;

	Aspose::Cells::Cleanup();
	return 0;
}

Cpp: 用 C++ 隐藏和排序数据透视表中的数据

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

隐藏和排序数据透视表中的数据

Aspose.Cells支持在数据透视表中隐藏和排序数据。以下代码片段演示了通过按得分列进行降序排序，然后隐藏得分小于60的行的功能。

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source and output directories
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Load the workbook
    Workbook workbook(srcDir + u"PivotTableHideAndSortSample.xlsx");

    // Get the first worksheet
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Get the first pivot table
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);
    CellArea dataBodyRange = pivotTable.GetDataBodyRange();
    int currentRow = 3;
    int rowsUsed = dataBodyRange.EndRow;

    // Sorting score in descending order
    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    pivotTable.CalculateData();

    // Hiding rows with score less than 60
    while (currentRow < rowsUsed)
    {
        Cell cell = worksheet.GetCells().Get(currentRow, 1);
        double score = cell.GetDoubleValue();
        if (score < 60)
        {
            worksheet.GetCells().HideRow(currentRow);
        }
        currentRow++;
    }

    pivotTable.CalculateData();

    // Save the Excel file
    workbook.Save(outDir + u"PivotTableHideAndSort_out.xlsx");

    std::cout << "Pivot table hide and sort completed successfully." << std::endl;

    Aspose::Cells::Cleanup();
}

代码示例中使用的源 Excel 文件和输出文件已附在文档中供参考。

源文件

输出文件

Cpp: 用C++进行数据透视表的自定义排序

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

数据透视表中的自定义排序

通过使用Aspose.Cells API，你可以按照字段值对数据透视表进行排序。以下代码片段加载示例Excel文件，并添加三个数据透视表。第一个没有自定义排序，第二个按照“海鲜”行字段值排序，第三个按照“28/07/2000”列字段值排序。

可从此处下载示例源文件和输出文件以测试示例代码：

源Excel文件

输出Excel文件

输出PDF文件

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Load the workbook
    Workbook wb(srcDir + u"SamplePivotSort.xlsx");

    // Get the first worksheet
    Worksheet sheet = wb.GetWorksheets().Get(0);

    // Get the pivot tables collection
    PivotTableCollection pivotTables = sheet.GetPivotTables();

    // Source PivotTable
    // Add a PivotTable to the worksheet
    int index = pivotTables.Add(u"=Sheet1!A1:C10", u"E3", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    PivotField rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    PivotField colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of source PivotTable

    // Sort the PivotTable on "SeaFood" row field values
    // Add a PivotTable to the worksheet
    index = pivotTables.Add(u"=Sheet1!A1:C10", u"E10", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);
    colField.SetAutoSortField(0);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of sort the PivotTable on "SeaFood" row field values

    // Sort the PivotTable on "28/07/2000" column field values
    // Add a PivotTable to the worksheet
    index = pivotTables.Add(u"=Sheet1!A1:C10", u"E18", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);
    rowField.SetAutoSortField(0);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of sort the PivotTable on "28/07/2000" column field values

    // Save the Excel file
    wb.Save(outDir + u"out_java.xlsx");

    // Save as PDF
    PdfSaveOptions options;
    options.SetOnePagePerSheet(true);
    wb.Save(outDir + u"out_java.pdf", options);

    Aspose::Cells::Cleanup();
}

Cpp: 透视筛选器（C++）

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

可能的使用场景

当你使用已知数据创建数据透视表并希望筛选时，你需要学习并使用筛选功能。它可以帮助你有效筛选出所需的数据。通过使用Aspose.Cells API，你可以在数据透视表中添加和清除字段值上的筛选。

在Excel中为数据透视表添加筛选

在Excel中为数据透视表添加筛选，按照以下步骤操作：

选择要清除筛选的数据透视表。
点击你想要添加筛选的下拉箭头。
从下拉菜单中选择“前十名”。
设置显示模式和筛选数量。

在数据透视表中添加筛选

请参阅以下示例代码。它设置数据并基于它创建数据透视表。然后在数据透视表的行字段上添加筛选器。最后，以[filterout.xlsx]格式保存工作簿。执行示例代码后，工作表中将添加一个带有Top10筛选器的数据透视表。

示例代码

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Create a new workbook
    Workbook workbook;

    // Get the first worksheet
    Worksheet ws = workbook.GetWorksheets().Get(0);
    Cells cells = ws.GetCells();

    // Set values to cells
    Cell cell = cells.Get(u"A1");
    cell.PutValue(u"Fruit");
    cell = cells.Get(u"B1");
    cell.PutValue(u"Count");

    cell = cells.Get(u"A2");
    cell.PutValue(u"Apple");
    cell = cells.Get(u"A3");
    cell.PutValue(u"Mango");
    cell = cells.Get(u"A4");
    cell.PutValue(u"Blackberry");
    cell = cells.Get(u"A5");
    cell.PutValue(u"Cherry");
    cell = cells.Get(u"A6");
    cell.PutValue(u"Guava");
    cell = cells.Get(u"A7");
    cell.PutValue(u"Carambola");
    cell = cells.Get(u"A8");
    cell.PutValue(u"Banana");
    cell = cells.Get(u"B2");
    cell.PutValue(5);
    cell = cells.Get(u"B3");
    cell.PutValue(3);
    cell = cells.Get(u"B4");
    cell.PutValue(6);
    cell = cells.Get(u"B5");
    cell.PutValue(4);
    cell = cells.Get(u"B6");
    cell.PutValue(5);
    cell = cells.Get(u"B7");
    cell.PutValue(2);
    cell = cells.Get(u"B8");
    cell.PutValue(20);

    // Add a PivotTable to the worksheet
    int32_t i = ws.GetPivotTables().Add(u"=A1:B8", u"D10", u"PivotTable1");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = ws.GetPivotTables().Get(i);
    pivotTable.AddFieldToArea(PivotFieldType::Row, 0);

    pivotTable.AddFieldToArea(PivotFieldType::Data, u"Count");
    pivotTable.GetDataFields().Get(0).SetFunction(ConsolidationFunction::Sum);

    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    // Add top10 filter
    PivotField filterField = pivotTable.GetRowFields().Get(0);
    filterField.FilterTop10(0, PivotFilterType::Count, false, 5);

    pivotTable.CalculateData();

    // Save the workbook
    workbook.Save(u"filterout.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

在Excel中清除数据透视表的筛选

在 Excel 中清除数据透视表中的筛选，按照以下步骤操作：

选择要清除筛选的数据透视表。
单击数据透视表中要清除筛选的下拉箭头。
从下拉菜单中选择“清除筛选”。
如果您要清除数据透视表中的所有筛选，还可以在 Excel 的“数据透视表分析”选项卡上单击“清除筛选”按钮。

清除数据透视表的筛选

使用 Aspose.Cells 在数据透视表中清除筛选。请参阅以下示例代码。

设置数据并创建基于该数据的数据透视表。
在数据透视表的行字段上添加筛选。
以 output XLSX 格式保存工作簿。执行示例代码后，将在工作表中添加带有 top10 筛选的数据透视表。
清除特定数据透视字段上的筛选。执行清除筛选的代码后，将清除特定数据透视字段上的筛选。请检查 output XLSX。

示例代码

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    // Create a new workbook
    Workbook workbook;

    // Get the first worksheet
    Worksheet ws = workbook.GetWorksheets().Get(0);
    Cells cells = ws.GetCells();

    // Set values to cells
    Cell cell = cells.Get(u"A1");
    cell.PutValue(u"Fruit");
    cell = cells.Get(u"B1");
    cell.PutValue(u"Count");

    cell = cells.Get(u"A2");
    cell.PutValue(u"Apple");
    cell = cells.Get(u"A3");
    cell.PutValue(u"Mango");
    cell = cells.Get(u"A4");
    cell.PutValue(u"Blackberry");
    cell = cells.Get(u"A5");
    cell.PutValue(u"Cherry");
    cell = cells.Get(u"A6");
    cell.PutValue(u"Guava");
    cell = cells.Get(u"A7");
    cell.PutValue(u"Carambola");
    cell = cells.Get(u"A8");
    cell.PutValue(u"Banana");
    cell = cells.Get(u"B2");
    cell.PutValue(5);
    cell = cells.Get(u"B3");
    cell.PutValue(3);
    cell = cells.Get(u"B4");
    cell.PutValue(6);
    cell = cells.Get(u"B5");
    cell.PutValue(4);
    cell = cells.Get(u"B6");
    cell.PutValue(5);
    cell = cells.Get(u"B7");
    cell.PutValue(2);
    cell = cells.Get(u"B8");
    cell.PutValue(20);

    // Add a PivotTable to the worksheet
    int i = ws.GetPivotTables().Add(u"=A1:B8", u"D10", u"PivotTable1");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = ws.GetPivotTables().Get(i);
    pivotTable.AddFieldToArea(PivotFieldType::Row, 0);

    pivotTable.AddFieldToArea(PivotFieldType::Data, u"Count");
    pivotTable.GetDataFields().Get(0).SetFunction(ConsolidationFunction::Sum);

    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    // Add top10 filter
    PivotField filterField = pivotTable.GetRowFields().Get(0);
    filterField.FilterTop10(0, PivotFilterType::Count, false, 5);

    pivotTable.CalculateData();

    workbook.Save(u"out_add.xlsx");

    // Clear PivotFilter from the specific PivotField
    pivotTable.GetPivotFilters().ClearFilter(field.GetBaseIndex());
    pivotTable.CalculateData();

    workbook.Save(u"out_delete.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}