PivotField класс

PivotField класс

Представляет поле в отчете сводной таблицы.

Тип PivotField предоставляет следующие элементы:

Характеристики

СвойствоОписание
pivot_itemsПолучает опорные элементы опорного поля
rangeПолучает диапазон группы поля опорной точки
group_settingsПолучает групповые настройки поля сводки.
is_calculated_fieldУказывает, является ли указанное поле сводной таблицы вычисляемым полем.
is_value_fieldsУказывает, представляет ли это поле поля значений.
base_indexПредставляет индекс PivotField в базовых PivotFields.
positionПредставляет индекс PivotField в регионе.
region_typeУказывает область сводной таблицы, в которой отображается это поле.
nameПредставляет имя PivotField.
display_nameПредставляет отображаемое имя PivotField.
is_auto_subtotalsУказывает, отображаются ли в указанном поле автоматические промежуточные итоги. Значение по умолчанию — true.
drag_to_columnУказывает, можно ли перетащить указанное поле в позицию столбца.
Значение по умолчанию — true.
drag_to_hideУказывает, можно ли перетащить указанное поле в положение скрытия.
Значение по умолчанию — true.
drag_to_rowУказывает, можно ли перетащить указанное поле в позицию строки.
Значение по умолчанию — true.
drag_to_pageУказывает, можно ли перетащить указанное поле на страницу.
Значение по умолчанию — true.
drag_to_dataУказывает, можно ли перетащить указанное поле в позицию данных.
Значение по умолчанию — true.
is_multiple_item_selection_allowedуказывает, может ли поле иметь несколько элементов
выбрано в поле страницы
Значение по умолчанию — false.
is_repeat_item_labelsУказывает, повторяются ли метки поля в регионе.
Значение по умолчанию — false.
is_include_new_items_in_filterУказывает, следует ли включать новые элементы в поле при ручном фильтре.
Значение по умолчанию — false.
is_insert_page_breaks_between_itemsУказывает, будет ли вставка разрыва страницы после каждого элемента.
Значение по умолчанию — false.
show_all_itemsУказывает, отображаются ли все элементы в отчете сводной таблицы,
даже если они не содержат сводных данных.
показать элементы без данных
Значение по умолчанию — false.
non_auto_sort_defaultУказывает, является ли операция сортировки, которая будет применена к этому полю сводной таблицы, операцией автоматической сортировки или простой сортировкой данных.
is_auto_sortУказывает, сортируется ли указанное поле сводной таблицы автоматически.
is_ascend_sortУказывает, сортируется ли указанное поле сводной таблицы автоматически по возрастанию.
sort_settingПолучает все настройки автосортировки
auto_sort_fieldПредставляет индекс поля, которое сортируется автоматически.
-1 означает само PivotField, остальные означают положение полей данных.
is_auto_showУказывает, отображается ли указанное поле сводной таблицы автоматически. Действительно только для Excel 2003.
is_ascend_showУказывает, отображается ли указанное поле сводной таблицы автоматически по возрастанию.
auto_show_countПредставляет количество верхних или нижних элементов
которые автоматически отображаются в указанном поле сводной таблицы.
auto_show_fieldПредставляет индекс поля автоматического показа. -1 означает сам PivotField.
Это должен быть индекс полей данных.
functionПредставляет функцию, используемую для суммирования поля данных сводной таблицы.
show_values_settingПолучает настройки отображения значений, когда используется расчет ShowDataAs.
data_display_formatПоказывает, как отображать значения в поле данных сводного отчета.
base_field_indexПредставляет базовое поле для пользовательского расчета, когда используется расчет ShowDataAs.
base_item_positionПредставляет элемент в базовом поле для пользовательского расчета, когда используется расчет ShowDataAs.
Действительно только для полей данных.
Поскольку PivotItemPosition.Custom предназначен только для чтения, если вам нужно установить PivotItemPosition.Custom,
пожалуйста, установите атрибут PivotField.BaseItemIndex.
base_item_indexПредставляет элемент в базовом поле для пользовательского расчета, когда используется расчет ShowDataAs.
Действительно только для полей данных.
current_page_itemПредставляет текущий элемент страницы, отображаемый для поля страницы (действительно только для полей страницы).
numberПредставляет встроенный формат отображения чисел и дат.
insert_blank_rowУказывает, следует ли вставлять пустую строку после каждого элемента.
show_subtotal_at_topесли ShowInOutlineForm имеет значение true, то отображать промежуточные итоги в верхней части списка элементов, а не в нижней.
show_in_outline_formУказывает, следует ли отображать это поле в виде структуры в представлении сводной таблицы.
number_formatПредставляет собой пользовательский формат отображения чисел и дат.
itemsПолучить все метки элементов сводки в этом поле.
original_itemsПолучите оригинальные базовые предметы;
item_countПолучает количество базовых элементов в этом сводном поле.
show_compactУказывает, отображать ли метки из следующего поля в том же столбце в представлении сводной таблицы.

Методы

МетодОписание
group_by(self, interval, new_field)Автоматически группировать поле с внутренними
group_by(self, start, end, groups, interval, first_as_new_field)Сгруппируйте файл по типу группы дат.
group_by(self, start, end, interval, new_field)Сгруппируйте файл по номеру.
group_by(self, custom_group_items, new_field)Пользовательская группа полей.
sort_by(self, sort_type, field_sorted_by)Сортирует это опорное поле.
sort_by(self, sort_type, field_sorted_by, data_type, cell_name)Сортирует это опорное поле.
hide_item(self, index, is_hidden)Устанавливает, будет ли скрыт определенный PivotItem в поле данных.
hide_item(self, item_value, is_hidden)Устанавливает, будет ли скрыт определенный PivotItem в поле данных.
init_pivot_items(self)Инициализируйте элементы опорной области опорной области.
ungroup(self)Разгруппируйте поле поворота.
get_pivot_filter_by_type(self, type)Получает фильтр сводной таблицы для поля сводной таблицы по типу
get_pivot_filters(self)Получает фильтры опорной области опорного поля
get_filters(self)Получает все фильтры сводки для этого поля сводки.
clear_filter(self)Очищает настройки фильтра для этого поля сводки.
filter_top10(self, value_field_index, type, is_top, item_count)Фильтрует по значениям поля сводных данных.
filter_by_value(self, value_field_index, type, value1, value2)Фильтрует по значениям поля сводных данных.
filter_by_label(self, type, label1, label2)Фильтрует по заголовкам поля сводной строки или столбца.
filter_by_date(self, type, date_time1, date_time2)Фильтрует по настройке даты сводного поля строки или столбца.
get_calculated_field_formula(self)Получить строку формулы указанного вычисляемого поля.
get_formula(self)Получает формулу вычисляемого поля.
set_subtotals(self, subtotal_type, shown)Устанавливает, отображает ли указанное поле промежуточные итоги.
get_subtotals(self, subtotal_type)Указывает, отображается ли указанный промежуточный итог.
show_values_as(self, display_format, base_field, base_item_position_type, base_item)Показывает значения поля данных в другом формате отображения, если используется расчет ShowDataAs.
is_hidden_item(self, index)Указывает, скрыт ли конкретный PivotItem.
is_hidden_item_detail(self, index)Получает информацию о том, скрыты ли сведения о конкретном PivotItem.
hide_item_detail(self, index, is_hidden_detail)Устанавливает, является ли конкретный PivotItem в поле сводки скрытой информацией.
hide_detail(self, is_hidden_detail)Устанавливает, является ли PivotItems в поле сводки скрытой информацией. То есть сворачивает/разворачивает это поле.
add_calculated_item(self, name, formula)Добавьте вычисляемый элемент формулы в поле сводной таблицы.

Пример

from aspose.cells import Workbook
from aspose.cells.pivot import PivotFieldType, PivotTableStyleType

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"
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

Смотрите также