Excel JavaScript API 1.12 中的新增功能

  • 项目

ExcelApi 1.12 添加了用于跟踪动态数组和查找公式的直接先例的 API，从而增加了对区域中公式的支持。 它还添加了数据透视表筛选器的 API 控件。 注释、区域性设置和自定义属性功能区域也进行了改进。

功能区域 说明 相关对象
注释事件 将用于添加、更改和删除的事件添加到注释集合。 CommentCollection
日期和时间 区域性设置 允许访问有关日期和时间格式的其他区域性设置。 CultureInfo、 NumberFormatInfo应用程序
直接先例 返回用于计算单元格公式的区域。 区域
透视筛选器 将值驱动的筛选器应用于数据透视表的字段。 PivotField、 PivotFilters
范围溢出 允许加载项查找与 动态数组 结果关联的区域。 区域
工作表级别的自定义属性 允许将自定义属性的范围限定为工作表级别，以及将范围限定为工作簿级别。 WorksheetCustomProperty、 WorksheetCustomPropertyCollection

API 列表

下表列出了 Excel JavaScript API 要求集 1.12 中的 API。 若要查看 Excel JavaScript API 要求集 1.12 或更低版本支持的所有 API 的 API 参考文档，请参阅 要求集 1.12 或更低版本中的 Excel API。

类 域 说明
ChartAxisTitle textOrientation 为图表轴标题指定文本所指向的角度。
ChartSeries getDimensionValues (维度：Excel.ChartSeriesDimension) 从图表系列的单个维度获取值。
Comment contentType 获取批注的内容类型。
CommentAddedEventArgs commentDetails CommentDetail获取包含其相关答复的注释 ID 和 ID 的数组。
source 指定时间源。
type 获取事件的类型。
worksheetId 获取发生事件的工作表的 ID。
CommentChangedEventArgs changeType 获取表示更改事件的触发方式的更改类型。
commentDetails CommentDetail获取包含其相关答复的注释 ID 和 ID 的数组。
source 指定时间源。
type 获取事件的类型。
worksheetId 获取发生事件的工作表的 ID。
CommentCollection onAdded 添加注释时发生。
onChanged 在批注集合中的批注或答复发生更改时发生，包括删除答复时。
onDeleted 在批注集合中删除批注时发生。
CommentDeletedEventArgs commentDetails CommentDetail获取包含其相关答复的注释 ID 和 ID 的数组。
source 指定时间源。
type 获取事件的类型。
worksheetId 获取发生事件的工作表的 ID。
CommentDetail commentId 表示注释的 ID。
replyIds 表示属于批注的相关答复的 ID。
CommentReply contentType 答复的内容类型。
CultureInfo datetimeFormat 定义显示日期和时间在区域性上合适的格式。
DatetimeFormatInfo dateSeparator 获取用作日期分隔符的字符串。
longDatePattern 获取长日期值的格式字符串。
longTimePattern 获取长时间值的格式字符串。
shortDatePattern 获取短日期值的格式字符串。
timeSeparator 获取用作时间分隔符的字符串。
PivotDateFilter 比较 比较器是与其他值进行比较的静态值。
条件 指定筛选器的条件，该条件定义必要的筛选条件。
独家 如果 true为 ，则筛选器 排除 满足条件的项目。
lowerBound 筛选条件的范围的 between 下限。
upperBound 筛选条件的范围 between 上限。
wholeDays 对于 equals、 before、 after和 between 筛选器条件，指示是否应将比较作为整天进行。
PivotField applyFilter (筛选器：Excel.PivotFilters) 设置字段的一个或多个当前数据透视筛选器，并将其应用于字段。
clearAllFilters () 清除所有字段筛选器中的所有条件。
clearFilter (filterType：Excel.PivotFilterType) 清除给定类型的字段筛选器中的所有现有条件， (当前) 应用条件。
getFilters () 获取字段上当前应用的所有筛选器。
isFiltered (filterType？： Excel.PivotFilterType) 检查字段上是否有任何已应用的筛选器。
PivotFilters dateFilter PivotField 当前应用的日期筛选器。
labelFilter PivotField 当前应用的标签筛选器。
manualFilter PivotField 当前应用的手动筛选器。
valueFilter PivotField 的当前应用值筛选器。
PivotLabelFilter 比较 比较器是与其他值进行比较的静态值。
条件 指定筛选器的条件，该条件定义必要的筛选条件。
独家 如果 true为 ，则筛选器 排除 满足条件的项目。
lowerBound 筛选条件的范围的 between 下限。
substring 用于 、 endsWith和 contains 筛选条件的beginsWith子字符串。
upperBound 筛选条件的范围 between 上限。
PivotManualFilter selectedItems 要手动筛选的选定项的列表。
PivotTable allowMultipleFiltersPerField 指定数据透视表是否允许在表中的给定数据透视字段上应用多个数据透视筛选器。
PivotTableScopedCollection getCount() 获取集合中数据透视表的数目。
getFirst() 获取集合中的第一个数据透视表。
getItem(key: string) 按名称获取 PivotTable 对象。
getItemOrNullObject(name: string) 按名称获取 PivotTable 对象。
items 获取此集合中已加载的子项。
PivotValueFilter 比较 比较器是与其他值进行比较的静态值。
条件 指定筛选器的条件，该条件定义必要的筛选条件。
独家 如果 true为 ，则筛选器 排除 满足条件的项目。
lowerBound 筛选条件的范围的 between 下限。
selectionType 指定筛选器是针对顶部/底部 N 项、顶部/底部 N 百分比还是顶部/底部 N 个总和。
阈 值 要根据顶部/底部筛选条件筛选的项数、百分比或总和的“N”阈值。
upperBound 筛选条件的范围 between 上限。
value 要筛选的字段中所选“值”的名称。
区域 getDirectPrecedents () 返回一个 WorkbookRangeAreas 对象，该对象表示包含同一工作表中或跨多个工作表的指定区域的所有直接引用单元格的区域。
getPivotTables (fullyContained？： boolean) 获取与区域重叠的数据透视表的作用域集合。
getSpillParent() 获取 Range 对象，它包含要将某个单元格溢出到的定位单元格。
getSpillParentOrNullObject() 获取包含要溢出到的单元格的定位单元格的范围对象。
getSpillingToRange() 获取 Range 对象，它在调用定位单元格时包含溢出区域。
getSpillingToRangeOrNullObject() 获取 Range 对象，它在调用定位单元格时包含溢出区域。
hasSpill 表示所有单元格是否都具有溢出边框。
numberFormatCategories 表示每个单元格的数字格式的类别。
savedAsArray 表示是否将所有单元格另存为数组公式。
RangeAreasCollection getCount() 获取此集合中的对象数 RangeAreas 。
getItemAt(index: number) RangeAreas基于集合中的位置返回 对象。
items 获取此集合中已加载的子项。
WorkbookRangeAreas 地址 返回 A1 样式的地址数组。
areas 返回 RangeAreasCollection 对象。
getRangeAreasBySheet (键：string) RangeAreas基于集合中的工作表 ID 或名称返回 对象。
getRangeAreasOrNullObjectBySheet (键：string) RangeAreas根据集合中的工作表名称或 ID 返回 对象。
范围 返回在 对象中 RangeCollection 构成此对象的区域。
Worksheet customProperties 获取工作表级自定义属性的集合。
WorksheetCustomProperty delete() 删除 custom property 对象。
key 获取 customProperty 的键。
value 获取或设置自定义属性的值。
WorksheetCustomPropertyCollection add (key： string， value： string) 添加映射到提供的键的新自定义属性。
getCount() 获取此工作表上的自定义属性数。
getItem(key: string) 按键获取自定义属性对象（不区分大小写）。
getItemOrNullObject(key: string) 按键获取自定义属性对象（不区分大小写）。
items 获取此集合中已加载的子项。

另请参阅