PivotTable类
PivotTable类
PivotTable 的摘要说明。
PivotTable 类型公开以下成员：
属性
| 属性 | 描述 |
|---|---|
| is_excel_2003_compatible | 指定刷新数据透视表时数据透视表是否兼容Excel2003， 如果为 true，则字符串必须小于或等于 255 个字符，因此如果字符串大于 255 个字符， 它将被截断。如果为假，则字符串将不会有上述限制。 默认值为 true。 |
| refreshed_by_who | 获取最后刷新此数据透视表的用户的名称 |
| refresh_date | 获取数据透视表上次刷新的日期时间。 |
| pivot_table_style_name | 获取并设置数据透视表样式名称。 |
| pivot_table_style_type | 获取并设置内置数据透视表样式。 |
| column_fields | 返回当前显示为列字段的 PivotFields 对象。 |
| row_fields | 返回当前显示为行字段的 PivotFields 对象。 |
| page_fields | 返回当前显示为页面字段的 PivotFields 对象。 |
| data_fields | 获取一个 PivotField 对象，该对象表示数据透视表中的所有数据字段。 只读。仅当DataPiovtFiels中有两个或两个以上的数据字段时才会初始化。 它仅用于将 DataPivotField 添加到数据透视表的行/列区域。默认在行区域。 |
| data_field | 获取一个 PivotField 对象，该对象表示数据透视表中的所有数据字段。只读。 仅当数据区域中有两个或更多数据字段时才会创建它。 默认位于行区域。您可以使用 PivotTable.AddFieldToArea() 方法将其拖到行/列区域。 |
| base_fields | 返回数据透视表中的所有基本数据透视字段。 |
| pivot_filters | 返回数据透视表中数据透视字段的所有过滤器。 |
| column_range | 返回代表范围的 CellArea 对象 包含数据透视表中的列区域。只读。 |
| row_range | 返回代表范围的 CellArea 对象 包含数据透视表中的行区域。只读。 |
| data_body_range | 返回一个 CellArea 对象，该对象表示包含数据区域的范围位于标题行和插入行之间的列表中。只读。 |
| table_range1 | 返回一个 CellArea 对象，该对象代表包含整个数据透视表的范围， 但不包含页面字段。只读。 |
| table_range2 | 返回一个 CellArea 对象，该对象代表包含整个数据透视表的范围， 包含页面字段。只读。 |
| is_grid_drop_zones | 指示数据透视表是否显示经典数据透视表布局。 （允许在网格中拖动字段） |
| show_column_grand_totals | 指示是否显示此数据透视表的列总计。 |
| show_row_grand_totals | 指示是否显示数据透视表各行的总计。 |
| column_grand | 指示数据透视表是否显示列的总计。 |
| row_grand | 指示是否显示此数据透视表各行的总计。 |
| display_null_string | 指示当值为空时数据透视表是否显示自定义字符串。 |
| null_string | 获取包含空值的单元格中显示的字符串 当DisplayNullString属性为true时，默认值为空字符串。 |
| display_error_string | 指示数据透视表是否在包含错误的单元格中显示自定义字符串。 |
| data_field_header_name | 获取并设置数据透视表中值区域字段标题的名称。 |
| error_string | 获取包含错误的单元格中显示的字符串 当 DisplayErrorString 属性为 true 时，默认值为空字符串。 |
| is_auto_format | 指示数据透视表是否自动格式化。 勾选“自动套用表格格式”，这是 Excel 2003 数据透视表选项中的一项 |
| autofit_column_width_on_update | 指示更新时是否自动调整列宽 |
| auto_format_type | 获取并设置数据透视表的自动格式类型。 |
| has_blank_rows | 指示是否添加空白行。 此属性仅适用于需要添加空行的透视表自动格式类型。 |
| merge_labels | 如果指定的数据透视表的外部行项、列项、小计和总计标签使用合并单元格，则为 True。 |
| preserve_formatting | 指示刷新或重新计算数据透视表时是否保留格式。 |
| show_drill | 获取或设置是否显示展开/折叠按钮。 |
| enable_drilldown | 获取是否启用下钻。 |
| enable_field_dialog | 指示数据透视表字段对话框是否可用 当用户双击数据透视表字段时。 |
| enable_field_list | 指示数据透视表的字段列表是否在 Excel 视图上可用。 |
| enable_wizard | 指示数据透视表向导是否可用。 |
| subtotal_hidden_page_items | 指示数据透视表中是否隐藏页面字段项 包括在行和列小计、块总计和总计中。 默认值为 False。 |
| grand_total_name | 返回总计列或行标题中显示的标签。 默认值是字符串“Grand Total”。 |
| manual_update | 指示是否仅在用户请求时重新计算数据透视表。 |
| is_multiple_field_filters | 指定一个布尔值，指示数据透视表的字段是否可以设置多个过滤器。 |
| allow_multiple_filters_per_field | 指定一个布尔值，指示数据透视表的字段是否可以设置多个过滤器。 |
| missing_items_limit | 指定一个布尔值，指示数据透视表的字段是否可以设置多个过滤器。 |
| enable_data_value_editing | 指定一个布尔值，指示是否允许用户编辑数据透视表数据区域中的单元格。 在值区域中启用单元格编辑 |
| show_data_tips | 指定一个布尔值，指示是否应为数据透视表数据单元格显示工具提示。 |
| show_member_property_tips | 指定一个布尔值，指示是否应从数据透视表工具提示中省略成员属性信息。 |
| show_values_row | 指示是否显示值行。 |
| show_empty_col | 指示是否在表中包含空列 |
| show_empty_row | 指示是否在表中包含空行。 |
| field_list_sort_ascending | 指示数据透视表中的字段是否按字段列表中的非默认顺序排序。 |
| print_drill | 指定一个布尔值，指示是否应打印钻取指示器。 在数据透视表上显示时打印展开/折叠按钮。 |
| alt_text_title | 获取并设置改变文本的标题。 |
| alt_text_description | 获取 alt 文本的描述。 |
| name | 获取数据透视表的名称 |
| column_header_caption | 获取数据透视表的列标题。 |
| indent | 指定紧凑轴的缩进增量，可用于将报告布局设置为紧凑形式。 |
| row_header_caption | 获取数据透视表的行标题。 |
| show_row_header_caption | 指示数据透视表中是否显示行标题 指示是否显示字段标题和过滤器下拉菜单 |
| custom_list_sort | 指示排序数据时是否考虑内置自定义列表 |
| pivot_format_conditions | 获取数据透视表的格式条件。 |
| conditional_formats | 获取数据透视表的条件格式。 |
| page_field_order | 获取并设置页面字段添加到数据透视表布局的顺序。 |
| page_field_wrap_count | 获取数据透视表中每列或每行的页字段数。 |
| tag | 获取随数据透视表报告保存的字符串。 |
| save_data | 指示数据透视表的数据是否与工作簿一起保存。 |
| refresh_data_on_opening_file | 指示打开文件时是否刷新数据。 |
| refresh_data_flag | 指示是否刷新数据。 |
| source_type | 获取数据透视表的数据源类型。 |
| external_connection_data_source | 获取外部连接数据源。 |
| data_source | 获取并设置数据透视表的数据源。 |
| pivot_formats | 获取应用于数据透视表的格式的集合。 |
| item_print_titles | 指示是否应在每个打印页面的顶部重复 PivotItem 名称。 |
| repeat_items_on_each_printed_page | 指示行区域上的数据透视表项标题是否在表格形式的数据透视表字段的每个打印页面上重复。 |
| print_titles | 指示工作表的打印标题是否基于 在数据透视表上。默认值为 false。 |
| display_immediate_items | 指示行和列区域中的项目是否可见 当数据透视表的数据区域为空时。默认值为 true。 |
| is_selected | 指示是否选择了此数据透视表。 |
| show_pivot_style_row_header | 指示数据透视表中的行标题是否应应用该样式。 |
| show_pivot_style_column_header | 指示数据透视表中的列标题是否应应用该样式。 |
| show_pivot_style_row_stripes | 指示是否应用行条纹格式。 |
| show_pivot_style_column_stripes | 指示是否对列应用条纹格式。 |
| show_pivot_style_last_column | 指示是否应用列格式。 |
方法
例子
from aspose.cells import FormatConditionType, OperatorType, Workbook
from aspose.cells.pivot import PivotFieldType, PivotFilterType, PivotTableStyleType
from aspose.pydrawing import Color
book = Workbook()
sheet = book.worksheets[0]
cells = sheet.cells
cells.get(0, 0).value = "fruit"
cells.get(1, 0).value = "grape"
cells.get(2, 0).value = "blueberry"
cells.get(3, 0).value = "kiwi"
cells.get(4, 0).value = "cherry"
cells.get(5, 0).value = "grape"
cells.get(6, 0).value = "blueberry"
cells.get(7, 0).value = "kiwi"
cells.get(8, 0).value = "cherry"
cells.get(0, 1).value = "year"
cells.get(1, 1).value = 2020
cells.get(2, 1).value = 2020
cells.get(3, 1).value = 2020
cells.get(4, 1).value = 2020
cells.get(5, 1).value = 2021
cells.get(6, 1).value = 2021
cells.get(7, 1).value = 2021
cells.get(8, 1).value = 2021
cells.get(0, 2).value = "amount"
cells.get(1, 2).value = 50
cells.get(2, 2).value = 60
cells.get(3, 2).value = 70
cells.get(4, 2).value = 80
cells.get(5, 2).value = 90
cells.get(6, 2).value = 100
cells.get(7, 2).value = 110
cells.get(8, 2).value = 120
pivots = sheet.pivot_tables
pivotIndex = pivots.add("=Sheet1!A1:C9", "A12", "TestPivotTable")
pivot = pivots[pivotIndex]
pivot.add_field_to_area(PivotFieldType.ROW, "fruit")
pivot.add_field_to_area(PivotFieldType.COLUMN, "year")
pivot.add_field_to_area(PivotFieldType.DATA, "amount")
pivot.pivot_table_style_type = PivotTableStyleType.PIVOT_TABLE_STYLE_MEDIUM10
# Change PivotField's attributes
rowField = pivot.row_fields[0]
rowField.display_name = "custom display name"
# Add PivotFilter
index = pivot.pivot_filters.add(0, PivotFilterType.COUNT)
filter = pivot.pivot_filters[index]
filter.auto_filter.filter_top10(0, False, False, 2)
# Add PivotFormatCondition
formatIndex = pivot.pivot_format_conditions.add()
pfc = pivot.pivot_format_conditions[formatIndex]
fcc = pfc.format_conditions
fcc.add_area(pivot.data_body_range)
idx = fcc.add_condition(FormatConditionType.CELL_VALUE)
fc = fcc[idx]
fc.formula1 = "100"
fc.operator = OperatorType.GREATER_OR_EQUAL
fc.style.background_color = Color.red
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")
