Поделиться через


PivotTable Интерфейс

Определение

Представляет отчет сводной таблицы на листе. Объект сводной таблицы является членом PivotTables коллекции. Коллекция сводных таблиц содержит все объекты сводной таблицы на одном листе.

public interface class PivotTable
[System.Runtime.InteropServices.Guid("00020872-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotTable
Public Interface PivotTable
Атрибуты

Комментарии

Используйте PivotTables(index), где index — номер или имя индекса сводной таблицы, чтобы вернуть один объект сводной таблицы .

Так как программирование отчетов сводной таблицы может быть сложным, обычно проще всего записывать действия отчета сводной таблицы, а затем пересматривать записанный код. Чтобы записать макрос, наведите указатель мыши на пункт Макрос в меню Сервис и выберите пункт Записать новый макрос.

Свойства

_Default

Зарезервировано для внутреннего использования.

ActiveFilters

Указывает текущий активный фильтр в указанном PivotTableобъекте . Только для чтения.

Allocation

Возвращает или задает, следует ли выполнять инструкцию UPDATE CUBE для каждой измененной ячейки или только в том случае, если пользователь решает вычислить изменения при выполнении анализа "что если" в сводной таблице на основе источника данных OLAP.

AllocationMethod

Возвращает или задает метод, используемый для выделения значений при выполнении анализа "что если" в отчете сводной таблицы на основе источника данных OLAP.

AllocationValue

Возвращает или задает значение, выделяемое при выполнении анализа "что если" в отчете сводной таблицы на основе источника данных OLAP.

AllocationWeightExpression

Возвращает или задает весовое выражение многомерных выражений, используемое при выполнении анализа "что, если" в отчете сводной таблицы на основе источника данных OLAP.

AllowMultipleFilters

Задает или извлекает значение, указывающее, может ли к объекту PivotField одновременно применяться несколько фильтров. Для чтения и записи.

AlternativeText

Возвращает или задает описательную (альтернативную) текстовую строку для указанной сводной таблицы.

Application

Application Возвращает объект , представляющий приложение Microsoft Excel. Только для чтения.

CacheIndex

Возвращает или задает номер индекса кэша сводной таблицы. Для чтения и записи, Integer.

CalculatedMembers

Возвращает коллекцию, CalculatedMembers представляющую все вычисляемые члены и вычисляемые меры для сводной таблицы OLAP.

CalculatedMembersInFilters

Возвращает или задает, следует ли вычислять члены из серверов OLAP в фильтрах.

ChangeList

Возвращает коллекцию PivotTableChangeList , представляющую список изменений, внесенных в указанную сводную таблицу на основе источника данных OLAP.

ColumnFields[Object]

Возвращает объект , представляющий одно поле сводной таблицы ( PivotField объект) или коллекцию всех полей ( PivotFields объект), которые в настоящее время отображаются как поля столбцов. Только для чтения.

ColumnGrand

Значение true , если в отчете сводной таблицы отображаются общие итоги для столбцов. Для чтения и записи, Boolean.

ColumnRange

Range Возвращает объект , представляющий диапазон, содержащий область столбца в отчете сводной таблицы. Только для чтения.

CompactLayoutColumnHeader

Указывает подпись, отображаемый в заголовке столбца в формате компактного PivotTable макета строк. Для чтения и записи.

CompactLayoutRowHeader

Указывает подпись, отображаемый в заголовке строки в формате компактного PivotTable макета строки. Для чтения и записи.

CompactRowIndent

Возвращает или задает приращение отступа для PivotItems при включении формы макета компактных строк. Для чтения и записи.

Creator

Возвращает 32-битное целое число, указывающее на приложение, в котором объект был создан. Если объект был создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную шестнадцатеричной цифре 5843454C. Только для XlCreatorчтения .

CubeFields

Возвращает коллекцию CubeFields . Каждый CubeField объект содержит свойства элемента поля куба. Только для чтения.

DataBodyRange

Range Возвращает объект , представляющий диапазон, содержащий область данных в списке между строкой заголовка и строкой вставки. Только для чтения.

DataFields[Object]

Возвращает объект , представляющий одно поле сводной таблицы ( PivotField объект) или коллекцию всех полей ( PivotFields объект), которые в настоящее время отображаются как поля данных. Только для чтения.

DataLabelRange

Range Возвращает объект , представляющий диапазон, содержащий метки для полей данных в отчете сводной таблицы. Только для чтения.

DataPivotField

PivotField Возвращает объект , представляющий все поля данных в сводной таблице. Только для чтения.

DisplayContextTooltips

Определяет, отображаются ли подсказки для PivotTable ячеек. Для чтения и записи.

DisplayEmptyColumn

Возвращает значение True, если непустая ключевое слово многомерных выражений включена в запрос к поставщику OLAP для оси значений. Поставщик OLAP не будет возвращать пустые столбцы в результирующем наборе. Возвращает значение False, если непустая ключевое слово опущена. Для чтения и записи, Boolean.

DisplayEmptyRow

Возвращает значение True, если непустая ключевое слово многомерных выражений включена в запрос к поставщику OLAP для оси категорий. Поставщик OLAP не вернет пустые строки в результирующем наборе. Возвращает значение False, если непустая ключевое слово опущена. Для чтения и записи, Boolean.

DisplayErrorString

Значение true , если отчет сводной таблицы отображает настраиваемую строку ошибки в ячейках, содержащих ошибки. Значение по умолчанию — False. Для чтения и записи, Boolean.

DisplayFieldCaptions

Определяет, отображаются ли в сетке кнопки и PivotField субтитры для строк и столбцов. Для чтения и записи.

DisplayImmediateItems

Возвращает или задает логическое значение, указывающее, видны ли элементы в областях строк и столбцов, если область данных сводной таблицы пуста. Присвойте этому свойству значение False , чтобы скрыть элементы в областях строк и столбцов, если область данных сводной таблицы пуста. Значение по умолчанию — True.

DisplayMemberPropertyTooltips

Определяет, должны ли отображаться свойства элементов в подсказках. Для чтения и записи.

DisplayNullString

Значение true , если отчет сводной таблицы отображает настраиваемую строку в ячейках, содержащих значения NULL. Значение по умолчанию — True. Для чтения и записи, Boolean.

EnableDataValueEditing

Значение true , чтобы отключить оповещение о перезаписи пользователем значений в области данных сводной таблицы. Значение True также позволяет пользователю изменять значения данных, которые ранее не могли быть изменены. Значение по умолчанию — False. Для чтения и записи, Boolean.

EnableDrilldown

Значение true, если детализация включена. Значение по умолчанию — True. Для чтения и записи, Boolean.

EnableFieldDialog

Значение true , если диалоговое окно Поле сводной таблицы доступно, когда пользователь дважды щелкает поле сводной таблицы. Значение по умолчанию — True. Для чтения и записи, Boolean.

EnableFieldList

Значение False , чтобы отключить возможность отображения списка полей для сводной таблицы. Если список полей уже отображался, он исчезает. Значение по умолчанию — True. Для чтения и записи, Boolean.

EnableWizard

Значение true , если мастер сводной таблицы доступен. Значение по умолчанию — True. Для чтения и записи, Boolean.

EnableWriteback

Возвращает или задает значение, указывающее, включена ли запись обратно в источник данных для указанной сводной таблицы.

ErrorString

Возвращает или задает строку, отображаемую в ячейках, которые содержат ошибки, DisplayErrorString если свойство имеет значение True. Значение по умолчанию — пустая строка (""). Для чтения и записи, String.

FieldListSortAscending

Управляет порядком сортировки полей в списке PivotTable полей. Для чтения и записи.

GrandTotalName

Возвращает или задает метку текстовой строки, которая отображается в столбце или заголовке строки в указанном отчете сводной таблицы. Значение по умолчанию — строка "Общий итог". Для чтения и записи, String.

HasAutoFormat

Значение true , если отчет сводной таблицы автоматически форматируется при обновлении или при перемещении полей. Для чтения и записи, Boolean.

Hidden

Проверяет, существует ли сводная таблица на уровне листа. Boolean (bool in C#). Только для чтения

HiddenFields[Object]

Возвращает объект , представляющий одно поле сводной таблицы ( PivotField объект) или коллекцию всех полей ( PivotFields объект), которые в настоящее время не отображаются как поля строки, столбца, страницы или данных. Только для чтения.

InGridDropZones

Это свойство используется для переключения зон в сетке PivotTable для объекта . В некоторых случаях это также влияет на макет PivotTableобъекта . Для чтения и записи.

InnerDetail

Возвращает или задает имя поля, которое будет отображаться в виде сведений, если ShowDetail свойство имеет значение True для внутреннего поля строки или столбца. Для чтения и записи, String.

LayoutRowDefault

Это свойство задает параметры макета при PivotFields первом добавлении PivotTable в . Для чтения и записи.

Location

Возвращает или задает строку, представляющую левую верхнюю ячейку в тексте указанного PivotTableобъекта . Для чтения и записи.

ManualUpdate

Значение true , если отчет сводной таблицы пересчитывается только по запросу пользователя. Значение по умолчанию — False. Для чтения и записи, Boolean.

MDX

Возвращает строку, указывающую многомерные выражения (многомерные выражения), которые будут отправлены поставщику для заполнения текущего представления сводной таблицы. Только для чтения.

MergeLabels

Значение true , если элемент внешней строки, элемент столбца, промежуточный итог и общие метки указанного отчета сводной таблицы используют объединенные ячейки. Для чтения и записи, Boolean.

Name

Возвращает или задает имя объекта. Для чтения и записи, String.

NullString

Возвращает или задает строку, отображаемую в ячейках, которые содержат значения NULL, DisplayNullString если свойство имеет значение True. Значение по умолчанию — пустая строка (""). Для чтения и записи, String.

PageFieldOrder

Возвращает или задает порядок добавления полей страницы в макет отчета сводной таблицы. Может быть одной из следующих XlOrder констант: xlDownThenOver или xlOverThenDown. Константа по умолчанию — xlDownThenOver. Для чтения и записи, Integer.

PageFields[Object]

Возвращает объект , представляющий одно поле сводной таблицы ( PivotField объект) или коллекцию всех полей ( PivotFields объект), которые в настоящее время отображаются как поля страницы. Только для чтения.

PageFieldStyle

Возвращает или задает стиль, используемый в области поля привязанной страницы. Значением по умолчанию является строка NULL (стиль не применяется по умолчанию). Для чтения и записи, String.

PageFieldWrapCount

Возвращает или задает количество полей страницы в каждом столбце или строке отчета сводной таблицы. Для чтения и записи, Integer.

PageRange

Range Возвращает объект , представляющий диапазон, содержащий область страницы в отчете сводной таблицы. Только для чтения.

PageRangeCells

Range Возвращает объект , представляющий только ячейки в указанном отчете сводной таблицы, которые содержат поля страницы и раскрывающиеся списки элементов.

Parent

Возвращает родительский объект для указанного объекта. Только для чтения

PivotChart

Shape Возвращает объект , представляющий автономную сводную диаграмму для указанного скрытого отчета сводной таблицы. Только для чтения.

PivotColumnAxis

Возвращает объект, PivotAxis представляющий всю ось столбца. Только для чтения.

PivotFormulas

PivotFormulas Возвращает объект , представляющий коллекцию формул для указанного PivotTable отчета. Только для чтения.

PivotRowAxis

Возвращает объект, PivotAxis представляющий всю ось строк. Только для чтения.

PivotSelection

Возвращает или задает выбор сводной таблицы в стандартном формате выбора отчета сводной таблицы. Для чтения и записи, String.

PivotSelectionStandard

Возвращает или задает строку, указывающую выбор сводной таблицы в стандартном формате отчета сводной таблицы, используя параметры английского языка (США). Для чтения и записи.

PreserveFormatting

Это свойство имеет значение True , если форматирование сохраняется при обновлении или пересчете отчета с помощью таких операций, как сводка, сортировка или изменение элементов полей страницы. Для чтения и записи, Boolean.

PrintDrillIndicators

Указывает, печатаются ли индикаторы детализации PivotTableс помощью . Для чтения и записи.

PrintTitles

Значение true , если заголовки для печати листа заданы на основе отчета сводной таблицы. Значение False , если используются заголовки для печати листа. Значение по умолчанию — False. Для чтения и записи, Boolean.

RefreshDate

Возвращает дату последнего обновления отчета сводной таблицы. Дата и время даты и времени только для чтения.

RefreshName

Возвращает имя пользователя, который в последний раз обновлял данные отчета сводной таблицы или кэш сводной таблицы. Только для чтения, String.

RepeatItemsOnEachPrintedPage

Значение true , если метки строк, столбцов и элементов отображаются в первой строке каждой страницы при печати указанного отчета сводной таблицы. False, если метки печатаются только на первой странице. Значение по умолчанию — True. Для чтения и записи, Boolean.

RowFields[Object]

Возвращает объект , представляющий одно поле в отчете сводной таблицы ( PivotField объект) или коллекцию всех полей ( PivotFields объект), которые в настоящее время отображаются как поля строк. Только для чтения.

RowGrand

Значение true , если в отчете сводной таблицы отображаются общие итоги строк. Для чтения и записи, Boolean.

RowRange

Range Возвращает объект, представляющий диапазон, включая область строк в отчете сводной таблицы. Только для чтения.

SaveData

Значение true , если данные для отчета сводной таблицы сохраняются вместе с книгой. False, если сохранено только определение отчета. Для чтения и записи, Boolean.

SelectionMode

Возвращает или задает режим структурированного выбора отчета сводной таблицы. Чтение и запись XlPTSelectionMode.

ShowCellBackgroundFromOLAP

Значение true , если многомерное выражение (многомерное выражение), отправляемое Microsoft Excel на сервер, содержит BackColor свойство для каждой ячейки в области данных, соответствующей ячейке в наборе данных OLAP. Значение по умолчанию — False. Для чтения и записи, Boolean.

ShowDrillIndicators

Свойство ShowDrillIndicators используется для переключения отображения индикаторов детализации в PivotTable. Для чтения и записи.

ShowPageMultipleItemLabel

Если задано значение True (по умолчанию), в ячейке сводной таблицы на листе будет отображаться слово "(Несколько элементов)", когда элементы скрыты и в представлении сводной таблицы отображается сводная таблица. Для чтения и записи, Boolean.

ShowTableStyleColumnHeaders

Свойство ShowTableStyleColumnHeadersимеет значение True, если заголовки столбцов должны отображаться в PivotTable. Для чтения и записи.

ShowTableStyleColumnStripes

Логическое свойство отображает столбцы с полосами, в которых четные столбцы форматируются иначе, чем нечетные столбцы. Это упрощает PivotTablesчтение. Для чтения и записи.

ShowTableStyleLastColumn

Зарезервировано для внутреннего использования.

ShowTableStyleRowHeaders

Свойство ShowTableStyleRowHeaders имеет значение True, если заголовки строк должны отображаться в PivotTable. Для чтения и записи.

ShowTableStyleRowStripes

Свойство ShowTableStyleRowStripes отображает чередуемые строки, в которых четные строки форматируются иначе, чем нечетные строки. Это упрощает PivotTables чтение. Для чтения и записи.

ShowValuesRow

Возвращает или задает значение, указывающее, отображается ли строка значений.

Slicers

Возвращает коллекцию Slicers для указанной сводной таблицы.

SmallGrid

Значение true, если Microsoft Excel использует сетку шириной в две ячейки и двумя ячейками для только что созданного отчета сводной таблицы. False, если Excel использует пустой контур набора элементов. Для чтения и записи, Boolean.

SortUsingCustomLists

Свойство SortUsingCustomLists определяет, используются ли настраиваемые списки для сортировки элементов полей, как при инициализации PivotField , так и упорядочении PivotItems по их субтитрам, а затем при применении пользователем сортировки. Для чтения и записи.

SourceData

Возвращает источник данных для отчета сводной таблицы. Объект чтения и записи.

SubtotalHiddenPageItems

Значение true, если скрытые элементы полей страницы в отчете сводной таблицы включаются в промежуточные итоги строк и столбцов, блочные итоги и общие итоги. Значение по умолчанию — False. Для чтения и записи, Boolean.

Summary

Возвращает или задает описание, связанное с альтернативной текстовой строкой для указанной сводной таблицы.

TableRange1

Range Возвращает объект , представляющий диапазон, содержащий весь отчет сводной таблицы, но не включающий поля страницы. Только для чтения.

TableRange2

Range Возвращает объект , представляющий диапазон, содержащий весь отчет сводной таблицы, включая поля страницы. Только для чтения.

TableStyle

Возвращает или задает стиль, используемый в тексте отчета сводной таблицы. Значением по умолчанию является строка NULL (стиль не применяется по умолчанию). Для чтения и записи, String.

TableStyle2

Свойство TableStyle2 задает стиль, применяемый PivotTable к объекту PivotTable. Для чтения и записи.

Tag

Возвращает или задает строку, сохраненную в отчете сводной таблицы. Для чтения и записи, String.

TotalsAnnotation

Значение true , если рядом с каждым промежуточным итогом и общим значением в указанном отчете сводной таблицы отображается звездочка (*), если отчет основан на источнике данных OLAP. Значение по умолчанию — True. Для чтения и записи, Boolean.

VacatedStyle

Возвращает или задает стиль, применяемый к ячейкам, освобожденным при обновлении отчета сводной таблицы. Значением по умолчанию является строка NULL (стиль не применяется по умолчанию). Для чтения и записи, String.

Value

Имя отчета сводной таблицы. Для чтения и записи, String.

Version

Возвращает номер версии Microsoft Excel. Только для XlPivotTableVersionListчтения .

ViewCalculatedMembers

Если задано значение True (по умолчанию), можно просмотреть вычисляемые элементы для сводных таблиц OLAP. Для чтения и записи, Boolean.

VisibleFields[Object]

Возвращает объект , представляющий одно поле в отчете сводной таблицы ( PivotField объект) или коллекцию всех видимых полей ( PivotFields объект). Видимые поля отображаются как строки, столбцы, страницы или поля данных. Только для чтения.

VisualTotals

Значение true (по умолчанию), чтобы включить сводные таблицы OLAP для пересчета суммы после того, как элемент был скрыт из представления. Для чтения и записи, Boolean.

VisualTotalsForSets

Возвращает или задает значение, указывающее, следует ли включать отфильтрованные элементы в итоговые значения именованных наборов для указанной сводной таблицы.

Методы

_PivotSelect(String, XlPTSelectionMode)

Зарезервировано для внутреннего использования.

AddDataField(Object, Object, Object)

Добавляет поле данных в отчет сводной таблицы. PivotField Возвращает объект , представляющий новое поле данных.

AddFields(Object, Object, Object, Object)

Добавляет поля строк, столбцов и страниц в отчет сводной таблицы или отчет сводной диаграммы.

AllocateChanges()

Выполняет операцию обратной записи для всех измененных ячеек в отчете сводной таблицы на основе источника данных OLAP.

CalculatedFields()

Возвращает коллекцию CalculatedFields , представляющую все вычисляемые поля в указанном отчете сводной таблицы. Только для чтения.

ChangeConnection(WorkbookConnection)

Изменяет соединение указанного PivotTableобъекта .

ChangePivotCache(Object)

Изменяет значение PivotCache указанного PivotTableобъекта .

ClearAllFilters()

Метод ClearAllFilters() удаляет все фильтры, применяемые к объекту PivotTable. Сюда входит удаление всех фильтров в PivotFilters коллекции объекта, удаление примененной PivotTable вручную фильтрации и установка элемента по умолчанию для всех PivotFieldэлементов в области фильтра отчетов.

ClearTable()

Метод ClearTable() используется для очистки PivotTable. Очистка PivotTableвключает удаление всех полей и удаление всех фильтров и сортировки, примененных к PivotTables. Этот метод сбрасывает объект в PivotTable состояние, которое он имел сразу после его создания, прежде чем в него были добавлены какие-либо поля.

CommitChanges()

Выполняет операцию фиксации в источнике данных отчета сводной таблицы на основе источника данных OLAP.

ConvertToFormulas(Boolean)

Метод ConvertToFormulas(Boolean) является новым в 1st_Excel12 и используется для преобразования PivotTable в формулы куба.

CreateCubeFile(String, Object, Object, Object, Object)

Создает файл куба из отчета сводной таблицы, подключенного к источнику данных OLAP.

DiscardChanges()

Отменяет все изменения в измененных ячейках отчета сводной таблицы на основе источника данных OLAP.

DrillDown(PivotItem, Object)

Позволяет детализировать данные в иерархии кубов на основе OLAP или PowerPivot.

DrillTo(PivotItem, CubeField, Object)

Позволяет детализировать расположение в иерархии кубов на основе OLAP или PowerPivot.

DrillUp(PivotItem, Object, Object)

Позволяет детализировать данные в иерархии кубов на основе OLAP или PowerPivot.

Dummy15(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Зарезервировано для внутреннего использования.

Dummy2(Object, Object, Object, Object)

Представляет отчет сводной таблицы на листе. Объект сводной таблицы является членом PivotTables коллекции. Коллекция сводных таблиц содержит все объекты сводной таблицы на одном листе.

Format(XlPivotFormatType)

Задает для отчета сводной таблицы один из предопределенных форматов с отступом, без отступа или перекрестной табуляции.

GetData(String)

Возвращает данные из указанной ячейки сводной таблицы.

GetPivotData(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Возвращает объект Range со сведениями об элементе данных в отчете сводной таблицы.

ListFormulas()

Создает список вычисляемых элементов и полей сводной таблицы на отдельном листе.

PivotCache()

PivotCache Возвращает объект , представляющий кэш для указанного отчета сводной таблицы. Только для чтения.

PivotFields(Object)

Возвращает объект , представляющий либо одно поле сводной таблицы ( PivotField объект), либо коллекцию видимых и скрытых полей ( PivotFields объект) в отчете сводной таблицы. Только для чтения.

PivotSelect(String, XlPTSelectionMode, Object)

Выбирает часть отчета сводной таблицы.

PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Создает PivotTable объект . Этот метод не отображает мастер сводной таблицы. Этот метод недоступен для источников данных OLE DB. Add(PivotCache, Object, Object, Object, Object) Используйте метод , чтобы добавить кэш сводной таблицы, а затем создать отчет сводной таблицы на основе кэша.

PivotValueCell(Object, Object)

PivotValueCell Получите объект для заданной сводной таблицы при условии определенных индексов строк и столбцов.

RefreshDataSourceValues()

Извлекает текущие значения из источника данных для всех измененных ячеек в отчете сводной таблицы в режиме обратной записи.

RefreshTable()

Обновляет отчет сводной таблицы из исходных данных. Возвращает значение True в случае успешного выполнения.

RepeatAllLabels(XlPivotFieldRepeatLabels)

Задает, следует ли повторять метки элементов для всех сводных полей в указанной сводной таблице.

RowAxisLayout(XlLayoutRowType)

Этот метод используется для одновременного задания параметров макета для всех существующих PivotFieldэлементов.

ShowPages(Object)

Создает отчет сводной таблицы для каждого элемента в поле страницы. Каждый новый отчет создается на новом листе.

SubtotalLocation(XlSubtototalLocationType)

Этот метод изменяет расположение промежуточных итогов для всех существующих PivotFields. Изменение расположения промежуточных итогов имеет немедленный визуальный эффект только для полей в форме контура, но оно также будет задано для полей в табличной форме.

Update()

Обновления ссылку или отчет сводной таблицы.

Применяется к