Excel JavaScript API 1.14 中的新增功能

  • 项目

ExcelApi 1.14 添加了用于控制图表的数据表功能的对象、用于查找公式的所有单元格的方法，以及用于跟踪工作表保护状态更改的工作表保护事件。 它还为 、 ShapeCollection和 StyleCollection 等CommentCollection对象添加了多种getItemOrNullObject方法，以改进错误处理。

功能区域 说明 相关对象
图表数据表 控制图表上数据表的外观、格式设置和可见性。 Chart、 ChartDataTable、 ChartDataTableFormat
公式先例 返回公式的所有前置单元格。 区域
查询 检索名称、刷新日期和查询计数等Power Query属性。 Query、 QueryCollection
工作表保护事件 跟踪对工作表的保护状态的更改以及这些更改的源。 WorksheetProtectionChangedEventArgs， Worksheet， WorksheetCollection

API 列表

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

类 域 说明
AutoFilter clearColumnCriteria (columnIndex： number) 清除自动筛选的列筛选条件。
ChangeDirectionState deleteShiftDirection 表示 (方向，例如向上或向左) 删除单元格时剩余单元格将移动。
insertShiftDirection 表示 (方向，例如向下或向右) 插入新单元格或新单元格时现有单元格将移动。
Chart getDataTable () 获取图表上的数据表。
getDataTableOrNullObject () 获取图表上的数据表。
ChartDataTable format 表示图表数据表的格式，其中包括填充、字体和边框格式。
showHorizontalBorder 指定是否显示数据表的水平边框。
showLegendKey 指定是否显示数据表的图例键。
showOutlineBorder 指定是否显示数据表的边框。
showVerticalBorder 指定是否显示数据表的垂直边框。
visible 指定是否显示图表的数据表。
ChartDataTableFormat 边框 表示图表数据表的边框格式，包括颜色、线条样式和粗细。
fill 表示对象的填充格式，包括背景格式信息。
font 表示字体属性 (，例如当前 对象的字体名称、字号和颜色) 。
CommentCollection getItemOrNullObject (commentId： string) 根据其 ID 从集合中获取批注。
CommentReplyCollection getItemOrNullObject (commentReplyId： string) 返回由其 ID 标识的批注回复。
ConditionalFormatCollection getItemOrNullObject(id: string) 返回由其 ID 标识的条件格式。
GroupShapeCollection getItemOrNullObject(key: string) 使用形状的名称或 ID 获取形状。
Query error 从上次刷新查询时获取查询错误消息。
loadedTo 获取加载到对象类型的查询。
loadedToDataModel 指定是否将查询加载到数据模型。
名称 获取查询的名称。
refreshDate 获取上次刷新查询的日期和时间。
rowsLoadedCount 获取上次刷新查询时加载的行数。
QueryCollection getCount() 获取工作簿中的查询数。
getItem(key: string) 根据集合的名称从集合中获取查询。
items 获取此集合中已加载的子项。
区域 getPrecedents () 返回一个 对象，该对象表示包含同一 WorkbookRangeAreas 工作表中或跨多个工作表的指定区域的所有前置单元格的区域。
ShapeCollection getItemOrNullObject(key: string) 使用形状的名称或 ID 获取形状。
StyleCollection getItemOrNullObject(name: string) 按名称获取样式。
TableScopedCollection getItemOrNullObject(key: string) 按名称或 ID 获取表。
Workbook 查询 返回属于工作簿的Power Query查询的集合。
Worksheet onProtectionChanged 更改工作表保护状态时发生。
tabId 返回一个值，该值表示可由 Open Office XML 读取的此工作表。
WorksheetChangedEventArgs changeDirectionState 表示对删除或插入单元格时工作表中的单元格将移动的方向的更改。
triggerSource 表示事件的触发器源。
WorksheetCollection onProtectionChanged 更改工作表保护状态时发生。
WorksheetProtectionChangedEventArgs isProtected 获取工作表的当前保护状态。
源 事件的源。
type 获取事件的类型。
worksheetId 获取在其中更改保护状态的工作表的 ID。

另请参阅