Excel JavaScript API 1.4 的最近更新

  • 项目

下面介绍了要求集 1.4 中 Excel JavaScript API 的新增内容。

添加了已命名项和新属性

新属性：

  • comment
  • scope - 工作表或工作簿范围内的项目。
  • worksheet - 返回命名项的作用域为的工作表。

新方法：

  • add(name: string, reference: Range or string, comment: string) - 向给定范围的集合添加新名称。
  • addFormulaLocal(name: string, formula: string, comment: string) - 使用公式的用户区域设置向给定范围的集合添加新名称。

Excel 命名空间中的设置 API

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 列表

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

类 域 说明
BindingCollection getCount() 获取集合中的绑定数量。
getItemOrNullObject(id: string) 按 ID 获取绑定对象。
ChartCollection getCount() 返回工作表中的图表数。
getItemOrNullObject(name: string) 使用图表名称获取图表。
ChartPointsCollection getCount() 返回系列中的图表点数。
ChartSeriesCollection getCount() 返回集合中的系列数量。
NamedItem comment 指定与此名称关联的注释。
delete() 删除给定的名称。
getRangeOrNullObject() 返回与名称相关的 range 对象。
scope 指定名称的范围是工作簿还是特定工作表。
worksheet 返回已命名项限定到的工作表。
worksheetOrNullObject 返回指定项的范围所指向的工作表。
NamedItemCollection 添加 (名称： string， reference： Range |string， comment？： string) 将新名称添加到给定范围的集合。
addFormulaLocal (name： string， formula： string， comment？： string) 使用用户的公式区域设置，将新名称添加到给定范围的集合。
getCount() 获取集合中已命名项的数量。
getItemOrNullObject(name: string) NamedItem使用其名称获取对象。
PivotTableCollection getCount() 获取集合中的数据透视表的数量。
getItemOrNullObject(name: string) 按名称获取 PivotTable 对象。
区域 getIntersectionOrNullObject (anotherRange： Range |字符串) 获取表示指定区域的矩形交集的 range 对象。
getUsedRangeOrNullObject (valuesOnly？： boolean) 返回指定 range 对象的所用区域。
RangeViewCollection getCount() 获取集合中的对象数 RangeView 。
设置 delete() 删除 Setting 对象。
key 表示设置 ID 的键。
value 表示为此设置存储的值。
SettingCollection add (键： string， value： string |number |布尔值 |日期 |any[] |任何) 设置指定的 Setting 对象，或将其添加到工作簿中。
getCount() 获取集合中的设置数。
getItem(key: string) 通过键获取设置项。
getItemOrNullObject(key: string) 通过键获取设置项。
items 获取此集合中已加载的子项。
onSettingsChanged 更改文档中的设置时发生。
SettingsChangedEventArgs 设置 获取表示 Setting 引发设置更改事件的绑定的对象
TableCollection getCount() 获取集合中的表数量。
getItemOrNullObject(key: string) 按名称或 ID 获取表。
TableColumnCollection getCount() 获取表中的列数。
getItemOrNullObject (键： number |字符串) 按名称或 ID 获取 column 对象。
TableRowCollection getCount() 获取表格中的行数。
Workbook 设置 表示与工作簿关联的设置的集合。
Worksheet getUsedRangeOrNullObject (valuesOnly？： boolean) 使用的区域是包含分配了值或格式化的任何单元格的最小区域。
名字 一组范围限定到当前工作表的名称。
WorksheetCollection getCount (visibleOnly？：布尔) 获取集合中的工作表数量。
getItemOrNullObject(key: string) 使用其名称或 ID 获取 worksheet 对象。

另请参阅