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

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

  • Статья

ExcelApi 1.14 добавил объекты для управления функцией таблицы данных диаграммы, методом для поиска всех ячеек с прецедентами формулы и событиями защиты листа для отслеживания изменений состояния защиты листа. Он также добавил несколько методов для таких getItemOrNullObject объектов, как CommentCollection, ShapeCollectionи StyleCollection для улучшения обработки ошибок.

Функциональная область Описание Соответствующие объекты
Таблицы данных диаграммы Управление внешним видом, форматированием и видимостью таблиц данных на диаграммах. Chart, ChartDataTable, ChartDataTableFormat
Прецеденты формул Возвращает все ячейки прецедента формулы. Range
Запросы Получение Power Query атрибутов, таких как имя, дата обновления и количество запросов. Query, QueryCollection
События защиты листа Отслеживайте изменения состояния защиты листа и источника этих изменений. WorksheetProtectionChangedEventArgs, Worksheet, WorksheetCollection

Список API

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

Класс Поля Описание
AutoFilter clearColumnCriteria(columnIndex: number) Очищает критерии фильтра столбцов автофильтра.
ChangeDirectionState deleteShiftDirection Представляет направление (например, вверх или влево), в которое будут смещены остальные ячейки при удалении ячейки или ячеек.
InsertShiftDirection Представляет направление (например, вниз или вправо), которое будут сдвигать существующие ячейки при вставке новой ячейки или ячеек.
Chart getDataTable() Возвращает таблицу данных на диаграмме.
getDataTableOrNullObject() Возвращает таблицу данных на диаграмме.
ChartDataTable format Представляет формат таблицы данных диаграммы, включающую формат заливки, шрифта и границы.
showHorizontalBorder Указывает, должна ли отображаться горизонтальная граница таблицы данных.
showLegendKey Указывает, следует ли отображать ключ условных обозначений таблицы данных.
showOutlineBorder Указывает, должна ли отображаться граница структуры таблицы данных.
showVerticalBorder Указывает, должна ли отображаться вертикальная граница таблицы данных.
visible Указывает, должна ли отображаться таблица данных диаграммы.
ChartDataTableFormat граница Представляет формат границы таблицы данных диаграммы, включающую цвет, стиль линии и вес.
fill Представляет формат заливки объекта, включая сведения о форматировании фона.
font Представляет атрибуты шрифта (например, имя шрифта, размер шрифта и цвет) для текущего объекта.
CommentCollection getItemOrNullObject(commentId: string) Получает примечание из коллекции на основе его идентификатора.
CommentReplyCollection getItemOrNullObject(commentReplyId: string) Возвращает ответ на примечание, определенное по идентификатору.
ConditionalFormatCollection getItemOrNullObject(id: строка) Возвращает условный формат, определенный идентификатором.
GroupShapeCollection getItemOrNullObject(key: string) Возвращает фигуру, используя ее имя или идентификатор.
Query error Возвращает сообщение об ошибке запроса с момента последнего обновления запроса.
loadedTo Возвращает запрос, загруженный в тип объекта.
loadedToDataModel Указывает, загружен ли запрос в модель данных.
name Возвращает имя запроса.
refreshDate Возвращает дату и время последнего обновления запроса.
rowsLoadedCount Возвращает количество строк, которые были загружены при последнем обновлении запроса.
QueryCollection getCount() Возвращает количество запросов в книге.
getItem(key: string) Получает запрос из коллекции на основе его имени.
items Получает загруженные дочерние элементы в этой коллекции.
Range getPrecedents() WorkbookRangeAreas Возвращает объект , представляющий диапазон, содержащий все ячейки прецедентов указанного диапазона на одном листе или на нескольких листах.
ShapeCollection getItemOrNullObject(key: string) Возвращает фигуру, используя ее имя или идентификатор.
StyleCollection getItemOrNullObject(имя: строка) Получает стиль по имени.
TableScopedCollection getItemOrNullObject(key: string) Получает таблицу по имени или ИД.
Workbook Запросов Возвращает коллекцию Power Query запросов, входящих в книгу.
Worksheet onProtectionChanged Происходит при изменении состояния защиты листа.
tabId Возвращает значение, представляющее этот лист, который может быть прочитан с помощью Open Office XML.
WorksheetChangedEventArgs changeDirectionState Представляет изменение в направлении, в которое будут перемещаться ячейки на листе при удалении или вставке ячейки.
triggerSource Представляет источник триггера события.
WorksheetCollection onProtectionChanged Происходит при изменении состояния защиты листа.
WorksheetProtectionChangedEventArgs isProtected Возвращает текущее состояние защиты листа.
источник Источник события.
type Получает тип события.
worksheetId Возвращает идентификатор листа, на котором изменяется состояние защиты.

См. также