Excel.PivotTableCollection interface

Представляет коллекцию всех объектов PivotTable, входящих в состав книги или листа.

Методы

add(name, source, destination)

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

getCount()

Получает количество сводных таблиц в коллекции.

getItem(name)

Получает сводную таблицу по имени.

getItemOrNullObject(name)

Получает сводную таблицу по имени. Если сводная таблица не существует, возвращает пустой объект.

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

refreshAll()

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

Сведения о методе

add(name, source, destination)

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

add(
            name: string,
            source: Range | string | Table,
            destination: Range | string
        ): PivotTable;

Параметры

name
string

Имя новой сводной таблицы.

source
Range | string | Table

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

destination
Range | string

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

Возвращаемое значение

Примеры

async function main(context: Excel.RequestContext) {
    let rangeToAnalyze = context.workbook.worksheets.getItem("Data").getRange("A1:E21");
    let rangeToPlacePivot = context.workbook.worksheets.getItem("Pivot").getRange("A2");
    context.workbook.worksheets.getItem("Pivot").pivotTables.add("Farm Sales", rangeToAnalyze, rangeToPlacePivot);

    await context.sync();
}

getCount()

Получает количество сводных таблиц в коллекции.

getCount(): ClientResult<number>;

Возвращаемое значение

ClientResult<number>

getItem(name)

Получает сводную таблицу по имени.

getItem(name: string): PivotTable;

Параметры

name
string

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

Возвращаемое значение

getItemOrNullObject(name)

Получает сводную таблицу по имени. Если сводная таблица не существует, возвращает пустой объект.

getItemOrNullObject(name: string): PivotTable;

Параметры

name
string

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

Возвращаемое значение

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

load(propertyNames?: string | string[]): void;

Параметры

propertyNames
string | string[]

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

Возвращаемое значение

void

refreshAll()

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

refreshAll(): void;

Возвращаемое значение

void