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


Новые возможности API JavaScript для Excel 1.13

ExcelApi 1.13 добавил метод для вставки листов в книгу из строки в кодировке Base64 и событие для обнаружения активации книги. Она также увеличила поддержку формул в диапазонах, добавив API для отслеживания изменений формул и поиска прямых зависимых ячеек формул. Кроме того, она расширила поддержку сводной таблицы, добавив API-интерфейсы PivotLayout для управления замещаемым текстом, стилем и пустыми ячейками.

Функциональная область Описание Соответствующие объекты
События изменения формулы Отслеживайте изменения формул, включая источник и тип события, вызвавшего изменение. Worksheet.onFormulaChanged
Зависимые формулы Найдите прямые зависимые ячейки формулы. Range.getDirectDependents
Вставка листов Вставьте листы из другой книги в текущую книгу в виде строки в кодировке Base64. Workbook.insertWorksheetsFromBase64
Сводная таблица сводной таблицы Расширение класса PivotLayout, включая новую поддержку замещающего текста и управления пустой ячейкой. PivotLayout

Список API

В следующей таблице перечислены API в наборе обязательных api JavaScript для Excel 1.13. Справочную документацию по API для всех API, поддерживаемых набором обязательных API JavaScript для Excel 1.13 или более ранней версии, см. в статье Api Excel в наборе требований 1.13 или более ранней версии.

Класс Поля Описание
FormulaChangedEventDetail cellAddress Адрес ячейки, содержащей измененную формулу.
previousFormula Представляет предыдущую формулу до ее изменения.
InsertWorksheetOptions positionType Позиция вставки в текущей книге новых листов.
relativeTo Лист в текущей книге, на который ссылается WorksheetPositionType параметр .
sheetNamesToInsert Имена отдельных листов для вставки.
PivotLayout altTextDescription Замещающее текстовое описание сводной таблицы.
altTextTitle Замещающий заголовок сводной таблицы.
displayBlankLineAfterEachItem(display: boolean) Задает, следует ли отображать пустую строку после каждого элемента.
emptyCellText Текст, который автоматически заполняется в любую пустую ячейку в сводной таблице, если .fillEmptyCells == true
fillEmptyCells Указывает, должны ли пустые ячейки в сводной таблице заполняться emptyCellText.
repeatAllItemLabels(repeatLabels: boolean) Задает параметр "повторять все метки элементов" во всех полях сводной таблицы.
showFieldHeaders Указывает, отображает ли сводная таблица заголовки полей (заголовки полей и раскрывающиеся списки фильтров).
PivotTable refreshOnOpen Указывает, обновляется ли сводная таблица при открытии книги.
Range getDirectDependents() WorkbookRangeAreas Возвращает объект , представляющий диапазон, содержащий все прямые зависимые ячейки указанного диапазона на одном листе или на нескольких листах.
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string) Возвращает объект диапазона, включающий текущий диапазон и до края диапазона на основе указанного направления.
getMergedAreasOrNullObject() RangeAreas Возвращает объект , представляющий объединенные области в этом диапазоне.
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string) Возвращает объект диапазона, представляющий собой реберную ячейку области данных, соответствующую указанному направлению.
Table resize(newRange: range | string) Измените размер таблицы до нового диапазона.
Workbook insertWorksheetsFromBase64(base64File: string, options?: Excel.InsertWorksheetOptions) Вставляет указанные листы из исходной книги в текущую книгу.
onActivated Происходит при активации книги.
WorkbookActivatedEventArgs type Получает тип события.
Worksheet onFormulaChanged Происходит при изменении одной или нескольких формул на этом листе.
WorksheetCollection onFormulaChanged Происходит при изменении одной или нескольких формул на любом листе этой коллекции.
WorksheetFormulaChangedEventArgs formulaDetails Возвращает массив FormulaChangedEventDetail объектов, содержащих сведения обо всех измененных формулах.
источник Источник события.
type Получает тип события.
worksheetId Возвращает идентификатор листа, на котором была изменена формула.

См. также