Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
ExcelApi 1.12 увеличил поддержку формул в диапазонах, добавив API для отслеживания динамических массивов и поиска прямых прецедентов формул. Кроме того, добавлен элемент управления API для фильтров сводной таблицы. Также были внесены улучшения в области функций комментариев, параметров и региональных параметров и настраиваемых свойств.
| Функциональная область | Описание | Соответствующие объекты |
|---|---|---|
| Закомментировать события | Добавляет события для добавления, изменения и удаления в коллекцию комментариев. | CommentCollection |
| Параметры даты и времени и региональных параметров | Предоставляет доступ к дополнительным культурным параметрам форматирования даты и времени. | CultureInfo, Приложение NumberFormatInfo |
| Прямые прецеденты | Возвращает диапазоны, используемые для вычисления формулы ячейки. | Range |
| Фильтры сводных данных | Применяет фильтры на основе значений к полям сводной таблицы. | PivotField, PivotFilters |
| Разлив диапазона | Позволяет надстройкам находить диапазоны, связанные с результатами динамического массива . | Range |
| Настраиваемые свойства на уровне листа | Позволяет ограничить область настраиваемых свойств на уровне листа, а также область действия на уровне книги. | WorksheetCustomProperty, WorksheetCustomPropertyCollection |
Список API
В следующей таблице перечислены API в наборе обязательных api JavaScript для Excel 1.12. Справочную документацию по API для всех API, поддерживаемых набором обязательных API JavaScript для Excel 1.12 или более ранней версии, см. в статье Api Excel в наборе требований 1.12 или более ранней версии.
| Класс | Поля | Описание |
|---|---|---|
| ChartAxisTitle | textOrientation | Задает угол, на который ориентирован текст для заголовка оси диаграммы. |
| ChartSeries | getDimensionValues(dimension: Excel.ChartSeriesDimension) | Возвращает значения из одного измерения ряда диаграммы. |
| Comment | contentType | Возвращает тип содержимого комментария. |
| CommentAddedEventArgs | commentDetails |
CommentDetail Возвращает массив, содержащий идентификатор комментария и идентификаторы связанных ответов. |
| source | Указывает источник события. | |
| type | Получает тип события. | |
| worksheetId | Возвращает идентификатор листа, на котором произошло событие. | |
| CommentChangedEventArgs | changeType | Возвращает тип изменения, представляющий способ активации события изменения. |
| commentDetails |
CommentDetail Получите массив, содержащий идентификатор комментария и идентификаторы связанных ответов. |
|
| source | Указывает источник события. | |
| type | Получает тип события. | |
| worksheetId | Возвращает идентификатор листа, на котором произошло событие. | |
| CommentCollection | onAdded | Происходит при добавлении комментариев. |
| onChanged | Происходит при изменении комментариев или ответов в коллекции комментариев, в том числе при удалении ответов. | |
| onDeleted | Происходит при удалении комментариев в коллекции комментариев. | |
| CommentDeletedEventArgs | commentDetails |
CommentDetail Возвращает массив, содержащий идентификатор комментария и идентификаторы связанных ответов. |
| source | Указывает источник события. | |
| type | Получает тип события. | |
| worksheetId | Возвращает идентификатор листа, на котором произошло событие. | |
| CommentDetail | commentId | Представляет идентификатор комментария. |
| replyIds | Представляет идентификаторы связанных ответов, принадлежащих к комментарии. | |
| CommentReply | contentType | Тип содержимого ответа. |
| CultureInfo | datetimeFormat | Определяет формат отображения даты и времени, соответствующий культуре. |
| DatetimeFormatInfo | dateSeparator | Возвращает строку, используемую в качестве разделителя даты. |
| longDatePattern | Возвращает строку формата для длинного значения даты. | |
| longTimePattern | Возвращает строку формата для длительного значения времени. | |
| shortDatePattern | Возвращает строку формата для короткого значения даты. | |
| timeSeparator | Возвращает строку, используемую в качестве разделителя времени. | |
| PivotDateFilter | компаратор | Компаратор — это статическое значение, с которым сравниваются другие значения. |
| состояние | Указывает условие для фильтра, определяющее необходимые критерии фильтрации. | |
| исключительный | Если trueзадано значение , фильтр исключает элементы, соответствующие условиям. |
|
| lowerBound | Нижняя граница диапазона для between условия фильтра. |
|
| upperBound | Верхняя граница диапазона для between условия фильтра. |
|
| wholeDays | Для equalsусловий фильтра , before, afterи between указывает, следует ли сравнивать целые дни. |
|
| PivotField | applyFilter(filter: Excel.PivotFilters) | Задает один или несколько текущих PivotFilters поля и применяет их к полю. |
| clearAllFilters() | Очищает все критерии из всех фильтров поля. | |
| clearFilter(filterType: Excel.PivotFilterType) | Очищает все существующие критерии из фильтра поля заданного типа (если он применяется в данный момент). | |
| getFilters() | Возвращает все фильтры, применяемые в настоящее время к полю. | |
| isFiltered(filterType?: Excel.PivotFilterType) | Проверяет наличие примененных фильтров к полю. | |
| PivotFilters | dateFilter | Текущий фильтр даты сводного поля. |
| labelFilter | Текущий фильтр меток сводного поля. | |
| manualFilter | В настоящее время применяется фильтр PivotField вручную. | |
| valueFilter | Текущий фильтр значений сводного поля. | |
| PivotLabelFilter | компаратор | Компаратор — это статическое значение, с которым сравниваются другие значения. |
| состояние | Указывает условие для фильтра, определяющее необходимые критерии фильтрации. | |
| исключительный | Если trueзадано значение , фильтр исключает элементы, соответствующие условиям. |
|
| lowerBound | Нижняя граница диапазона для between условия фильтра. |
|
| substring | Подстрока, используемая для условий beginsWithфильтра , endsWithи contains . |
|
| upperBound | Верхняя граница диапазона для between условия фильтра. |
|
| PivotManualFilter | selectedItems | Список выбранных элементов для фильтрации вручную. |
| PivotTable | allowMultipleFiltersPerField | Указывает, допускает ли сводная таблица применение нескольких PivotFilter для заданного сводного поля в таблице. |
| PivotTableScopedCollection | getCount() | Возвращает количество сводных таблиц в коллекции. |
| getFirst() | Возвращает первую сводную таблицу в коллекции. | |
| getItem(key: string) | Получает сводную таблицу по имени. | |
| getItemOrNullObject(имя: строка) | Получает сводную таблицу по имени. | |
| items | Получает загруженные дочерние элементы в этой коллекции. | |
| PivotValueFilter | компаратор | Компаратор — это статическое значение, с которым сравниваются другие значения. |
| состояние | Указывает условие для фильтра, определяющее необходимые критерии фильтрации. | |
| исключительный | Если trueзадано значение , фильтр исключает элементы, соответствующие условиям. |
|
| lowerBound | Нижняя граница диапазона для between условия фильтра. |
|
| selectionType | Указывает, используется ли фильтр для верхнего или нижнего N элементов, верхнего или нижнего N процентов или верхней/нижней суммы N. | |
| порог | Пороговое число "N" элементов, процентов или сумм, которые должны быть отфильтрованы для верхнего или нижнего условий фильтра. | |
| upperBound | Верхняя граница диапазона для between условия фильтра. |
|
| value | Имя выбранного значения в поле, по которому выполняется фильтрация. | |
| Range | getDirectPrecedents() |
WorkbookRangeAreas Возвращает объект , представляющий диапазон, содержащий все ячейки прямого прецедента указанного диапазона на одном листе или на нескольких листах. |
| getPivotTables(fullyContained?: boolean) | Возвращает коллекцию сводных таблиц с заданной областью, перекрывающуюся с диапазоном. | |
| getSpillParent() | Получает объект диапазона, содержащий базовую ячейку для переносимой ячейки. | |
| getSpillParentOrNullObject() | Возвращает объект диапазона, содержащий ячейку привязки для ячейки, в нее попадает. | |
| getSpillingToRange() | Получает объект range, содержащий диапазон переноса при вызове для базовой ячейки. | |
| getSpillingToRangeOrNullObject() | Получает объект range, содержащий диапазон переноса при вызове для базовой ячейки. | |
| hasSpill | Указывает, есть ли во всех ячейках граница переноса. | |
| numberFormatCategories | Представляет категорию числового формата каждой ячейки. | |
| savedAsArray | Представляет, будут ли все ячейки сохранены в виде формулы массива. | |
| RangeAreasCollection | getCount() | Возвращает количество RangeAreas объектов в этой коллекции. |
| getItemAt(index: number) | Возвращает объект на RangeAreas основе позиции в коллекции. |
|
| items | Получает загруженные дочерние элементы в этой коллекции. | |
| WorkbookRangeAreas | addresses | Возвращает массив адресов в стиле A1. |
| areas |
RangeAreasCollection Возвращает объект . |
|
| getRangeAreasBySheet(key: string) | Возвращает объект на основе идентификатора RangeAreas листа или имени в коллекции. |
|
| getRangeAreasOrNullObjectBySheet(key: string) | Возвращает объект на RangeAreas основе имени листа или идентификатора в коллекции. |
|
| Диапазоны | Возвращает диапазоны, составляющие этот объект в объекте RangeCollection . |
|
| Worksheet | customProperties | Возвращает коллекцию настраиваемых свойств на уровне листа. |
| WorksheetCustomProperty | delete() | Удаляет настраиваемое свойство. |
| key | Возвращает ключ настраиваемого свойства. | |
| value | Задает значение настраиваемого свойства. | |
| WorksheetCustomPropertyCollection | add(key: string, value: string) | Добавляет новое пользовательское свойство, которое сопоставляется с предоставленным ключом. |
| getCount() | Возвращает количество настраиваемых свойств на этом листе. | |
| getItem(key: string) | Возвращает объект настраиваемого свойства по ключу, указываемому без учета регистра. | |
| getItemOrNullObject(key: string) | Возвращает объект настраиваемого свойства по ключу, указываемому без учета регистра. | |
| items | Получает загруженные дочерние элементы в этой коллекции. |
См. также
Сотрудничайте с нами на GitHub
Исходный код этого содержимого можно найти на GitHub, где вы также можете создавать и просматривать проблемы и запросы на вытягивание. Для получения дополнительной информации см. наше руководство для авторов.