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


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

Ниже перечислено то, что было недавно добавлено в набор обязательных элементов 1.4, относящийся к API JavaScript для Excel.

Именованный элемент add и новые свойства

Новые свойства:

  • comment
  • scope — Элементы с областью листа или книги.
  • worksheet — возвращает лист, на котором находится именованный элемент.

Новые методы:

  • add(name: string, reference: Range or string, comment: string)— добавляет новое имя в коллекцию заданного область.
  • addFormulaLocal(name: string, formula: string, comment: string)— добавляет новое имя в коллекцию заданного область, используя языковой стандарт пользователя для формулы.

Параметры API в пространстве имен Excel

Объект Setting представляет пару "ключ-значение" для параметра, хранящегося в документе. Функциональные возможности объекта Excel.Setting аналогичны Office.Settings, но он использует пакетный синтаксис API, а не модель обратного вызова общего API.

API включают в себя getItem() для получения записи параметра через ключ и add() добавления указанной пары "ключ:значение" в книгу.

Другие

  • Задайте имя столбца таблицы.
  • Добавьте столбец таблицы в конец таблицы.
  • Добавление нескольких строк в таблицу одновременно.
  • range.getColumnsAfter(count: number) и range.getColumnsBefore(count: number), чтобы вернуть определенное количество столбцов справа/слева от текущего объекта Range.
  • Методы и свойства *OrNullObject: эта функция позволяет получить объект с помощью ключа. Если объект не существует, свойство возвращаемого isNullObject объекта будет иметь значение true. Это позволяет разработчикам проверка, существует ли объект, не обрабатывая его с помощью обработки исключений. Метод *OrNullObject доступен для большинства объектов коллекции.
worksheet.getItemOrNullObject("itemName")

Список API

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

Класс Поля Описание
BindingCollection getCount() Получает количество привязок в коллекции.
getItemOrNullObject(id: строка) Возвращает объект привязки по идентификатору.
ChartCollection getCount() Возвращает количество диаграмм на листе.
getItemOrNullObject(имя: строка) Возвращает диаграмму по ее имени.
ChartPointsCollection getCount() Возвращает количество точек диаграммы в ряду.
ChartSeriesCollection getCount() Возвращает количество рядов в коллекции.
NamedItem comment Указывает комментарий, связанный с этим именем.
delete() Удаляет заданное имя.
getRangeOrNullObject() Возвращает объект Range, сопоставленный с именем.
scope Указывает, имеет ли имя область действия книги или определенного листа.
worksheet Возвращает лист, к которому относится именованный элемент.
worksheetOrNullObject Возвращает лист, для которого задана область именованного элемента.
NamedItemCollection add(name: string, reference: Range | string, comment?: string) Добавляет новое имя в определенную коллекцию.
addFormulaLocal(name: string, formula: string, comment?: string) Добавляет новое имя в определенную коллекцию, используя языковой стандарт пользователя для формулы.
getCount() Получает количество именованных элементов в коллекции.
getItemOrNullObject(имя: строка) Возвращает объект, NamedItem используя его имя.
PivotTableCollection getCount() Получает количество сводных таблиц в коллекции.
getItemOrNullObject(имя: строка) Получает сводную таблицу по имени.
Range getIntersectionOrNullObject(anotherRange: Range | string) Возвращает объект диапазона, представляющий прямоугольное пересечение заданных диапазонов.
getUsedRangeOrNullObject(valuesOnly?: boolean) Возвращает используемый диапазон заданного объекта диапазона.
RangeViewCollection getCount() Возвращает количество RangeView объектов в коллекции.
Параметр delete() Удаляет параметр.
key Ключ, представляющий идентификатор параметра.
value Представляет значение, сохраненное для этого параметра.
SettingCollection add(key: string, value: string | number | boolean | Дата | any[] | любой) Задает или добавляет указанный параметр в книгу.
getCount() Возвращает количество параметров в коллекции.
getItem(key: string) Возвращает запись параметра с помощью ключа.
getItemOrNullObject(key: string) Возвращает запись параметра с помощью ключа.
items Получает загруженные дочерние элементы в этой коллекции.
onSettingsChanged Происходит при изменении параметров в документе.
SettingsChangedEventArgs settings Setting Возвращает объект , представляющий привязку, которая вызвала событие изменения параметров.
TableCollection getCount() Получает количество таблиц в коллекции.
getItemOrNullObject(key: string) Получает таблицу по имени или ИД.
TableColumnCollection getCount() Получает количество столбцов в таблице.
getItemOrNullObject(key: number | string) Возвращает объект столбца по имени или идентификатору.
TableRowCollection getCount() Получает количество строк в таблице.
Workbook settings Представляет коллекцию параметров, связанных с книгой.
Worksheet getUsedRangeOrNullObject(valuesOnly?: boolean) Используемый диапазон — это наименьший диапазон, включающий в себя все ячейки с определенным значением или форматированием.
Имена Коллекция имен, относящих к текущему листу.
WorksheetCollection getCount(visibleOnly?: boolean) Получает количество листов в коллекции.
getItemOrNullObject(key: string) Получает объект листа по его имени или ИД.

См. также