PivotField Интерфейс

Определение

Представляет поле в отчете сводной таблицы. Объект PivotField является членом PivotFields коллекции. Коллекция PivotFields содержит все поля в отчете сводной таблицы, включая скрытые.

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

Комментарии

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

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

Свойства

_Default

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

AllItemsVisible

Извлекает значение, указывающее, применяется ли к объекту какая-либо ручная фильтрация Microsoft.Office.Interop.Excel.Pivotfield. Только для чтения.

Application

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

AutoShowCount

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

AutoShowField

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

AutoShowRange

Возвращает xlTop, если верхние элементы отображаются автоматически в указанном поле сводной таблицы; возвращает xlBottom, если отображаются нижние элементы. Только для чтения, Integer.

AutoShowType

Возвращает xlAutomatic , если AutoShow(Int32, Int32, Int32, String) включено для указанного поля сводной таблицы; возвращает значение xlManual , если автошоу отключено. Только для чтения, Integer.

AutoSortCustomSubtotal

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

AutoSortField

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

AutoSortOrder

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

AutoSortPivotLine

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

BaseField

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

BaseItem

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

Calculation

Возвращает или задает тип вычисления, выполняемого указанным полем. Это свойство допустимо только для полей данных. Чтение и запись XlPivotFieldCalculation.

Caption

Текст метки для поля сводки. Только для чтения, String.

ChildField

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

ChildItems[Object]

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

Creator

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

CubeField

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

CurrentPage

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

CurrentPageList

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

CurrentPageName

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

DatabaseSort

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

DataRange

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

DataType

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

DisplayAsCaption

Это свойство используется для отображения свойств элементов s PivotFieldв виде субтитров. Только для чтения.

DisplayAsTooltip

Это свойство используется для указания того, отображается ли определенное свойство-член PivotField в подсказках. Для чтения и записи.

DisplayInReport

Это свойство используется для указания того, отображается ли указанное свойство-член PivotField в объекте PivotTable . Для чтения и записи.

DragToColumn

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

DragToData

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

DragToHide

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

DragToPage

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

DragToRow

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

DrilledDown

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

EnableItemSelection

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

EnableMultiplePageItems

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

Formula

Возвращает или задает формулу объекта в нотации типа A1 Read/write String.

Function

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

GroupLevel

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

Hidden

Это свойство используется для скрытия отдельных уровней иерархии OLAP. Для чтения и записи.

HiddenItems[Object]

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

HiddenItemsList

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

IncludeNewItemsInFilter

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

IsCalculated

Значение true , если поле сводной таблицы или элемент сводной таблицы является вычисляемым полем или элементом. Только для чтения, Boolean.

IsMemberProperty

Возвращает значение True , если сводное поле содержит свойства элемента. Только для чтения, Boolean.

LabelRange

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

LayoutBlankLine

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

LayoutCompactRow

Указывает, уплотняется ли PivotField объект (элементы из нескольких PivotFieldэлементов отображаются в одном столбце) при выборе строк. Для чтения и записи.

LayoutForm

Возвращает или задает способ отображения указанных элементов сводной таблицы — в формате таблицы или в формате структуры. Чтение и запись XlLayoutFormType.

LayoutPageBreak

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

LayoutSubtotalLocation

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

MemberPropertyCaption

MemberPropertyCaption Задание свойства определяет, какое свойство-член используется в качестве подпись для заданного уровня. Для чтения и записи.

MemoryUsed

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

Name

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

NumberFormat

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

Orientation

Расположение поля в указанном отчете сводной таблицы. Чтение и запись XlPivotFieldOrientation.

Parent

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

ParentField

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

ParentItems[Object]

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

PivotFilters

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

Position

Положение поля (первого, второго, третьего и т. д.) среди всех полей в его ориентации (строки, столбцы, страницы, данные). Объект чтения и записи.

PropertyOrder

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

PropertyParentField

Возвращает объект, PivotField представляющий поле, к которому относятся свойства этого поля.

RepeatLabels

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

ServerBased

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

ShowAllItems

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

ShowDetail

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

ShowingInAxis

Указывает, отображается ли PivotField объект в данный момент в объекте PivotTable . Только для чтения.

SourceCaption

Свойство SourceCaption применимо только для OLAP PivotTableи возвращает исходную подпись с сервера OLAP для PivotField. Только для чтения.

SourceName

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

StandardFormula

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

SubtotalName

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

Subtotals[Object]

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

TotalLevels

Возвращает общее количество полей в текущей группе полей. Если поле не сгруппировано или источник данных основан на OLAP, TotalLevels возвращает значение 1. Только для чтения, Integer.

UseMemberPropertyAsCaption

Это свойство используется для управления тем, используются ли субтитры свойств-членов для PivotItem субтитров PivotFieldобъекта . Для чтения и записи.

Value

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

VisibleItems[Object]

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

VisibleItemsList

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

Методы

AddPageItem(String, Object)

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

AutoShow(Int32, Int32, Int32, String)

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

AutoSort(Int32, String)

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

AutoSortEx(Int32, String, Object, Object)

Представляет поле в отчете сводной таблицы. Объект PivotField является членом PivotFields коллекции. Коллекция PivotFields содержит все поля в отчете сводной таблицы, включая скрытые.

CalculatedItems()

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

ClearAllFilters()

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

ClearLabelFilters()

Этот метод удаляет все фильтры меток или все фильтры даты в PivotFilters коллекции PivotField.

ClearManualFilter()

Предоставляет простой способ присвоить свойству Visible значение True для всех элементов PivotField в PivotTablesи очистить коллекции HiddenItemsList и VisibleItemsList в OLAP PivotTables.

ClearValueFilters()

При вызове этого метода удаляются все фильтры значений в PivotFilters коллекции PivotFieldобъекта .

Delete()

Удаляет объект .

DrillTo(String)

Метод DrillTo поддерживает сверление до указанного PivotField объекта из другого PivotField.

PivotItems(Object)

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

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