Excel JavaScript API 1.6 的最近更新
条件格式
引入了范围的条件格式设置。 允许以下类型的条件格式设置。
- 色阶
- 数据栏
- 图标集
- 自定义
此外：
- 返回应用条件格式的区域。
- 删除条件格式。
- 提供优先级和
stopifTrue功能。 - 获取给定区域内所有条件格式的集合。
- 清除当前指定区域中处于活动状态的所有条件格式。
API 列表
下表列出了 Excel JavaScript API 要求集 1.6 中的 API。 若要查看 Excel JavaScript API 要求集 1.6 或更低版本支持的所有 API 的 API 参考文档，请参阅 要求集 1.6 或更低版本中的 Excel API。
| 类 | 域 | 说明 |
|---|---|---|
| Application | suspendApiCalculationUntilNextSync () | 暂停计算，直到调用下一个 context.sync() 。 |
| CellValueConditionalFormat | format | 返回格式对象，该对象封装条件格式字体、填充、边框和其他属性。 |
| 统治 | 指定此条件格式的规则对象。 | |
| ColorScaleConditionalFormat | criteria | 色阶的条件。 |
| threeColorScale | 如果 true为 ，则色阶 (最小值、中点、最大) 三个点，否则将具有两个 (最小、最大) 。 |
|
| ConditionalCellValueRule | formula1 | 计算条件格式规则的公式（如果需要）。 |
| formula2 | 计算条件格式规则的公式（如果需要）。 | |
| operator | 单元格值条件格式的运算符。 | |
| ConditionalColorScaleCriteria | maximum | 色阶条件的最大点。 |
| 中点 | 如果色阶为 3 色阶，则为色阶条件的中点。 | |
| minimum | 色阶条件的最小点。 | |
| ConditionalColorScaleCriterion | color | 色阶颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。 |
| formula | 数字、公式或 null (（如果 type 为 lowestValue) ）。 |
|
| type | 条件公式应基于什么。 | |
| ConditionalDataBarNegativeFormat | borderColor | 表示边框线颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“橙色”) 。 |
| fillColor | 表示填充颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“orange”) 。 | |
| matchPositiveBorderColor | 指定负数据条是否与正数据条具有相同的边框颜色。 | |
| matchPositiveFillColor | 指定负数据条是否与正数据条具有相同的填充颜色。 | |
| ConditionalDataBarPositiveFormat | borderColor | 表示边框线颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“橙色”) 。 |
| fillColor | 表示填充颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“orange”) 。 | |
| gradientFill | 指定数据条是否具有渐变。 | |
| ConditionalDataBarRule | formula | 计算数据条规则的公式（如果需要）。 |
| type | 数据栏的规则类型。 | |
| ConditionalFormat | cellValue | 如果当前条件格式是 CellValue 类型，则返回单元格值条件格式属性。 |
| cellValueOrNullObject | 如果当前条件格式是 CellValue 类型，则返回单元格值条件格式属性。 |
|
| colorScale | 如果当前条件格式是 ColorScale 类型，则返回色阶条件格式属性。 |
|
| colorScaleOrNullObject | 如果当前条件格式是 ColorScale 类型，则返回色阶条件格式属性。 |
|
| 习惯 | 如果当前条件格式是自定义类型，则返回自定义条件格式属性。 | |
| customOrNullObject | 如果当前条件格式是自定义类型，则返回自定义条件格式属性。 | |
| dataBar | 如果当前条件格式为数据条，则返回数据条属性。 | |
| dataBarOrNullObject | 如果当前条件格式为数据条，则返回数据条属性。 | |
| delete() | 删除此条件格式。 | |
| getRange() | 返回应用条件格式的区域。 | |
| getRangeOrNullObject() | 返回应用条件格式的区域。 | |
| iconSet | 如果当前条件格式是类型 IconSet ，则返回图标集条件格式属性。 |
|
| iconSetOrNullObject | 如果当前条件格式是类型 IconSet ，则返回图标集条件格式属性。 |
|
| id | 当前 ConditionalFormatCollection中条件格式的优先级。 |
|
| 预设 | 返回预设条件条件格式。 | |
| presetOrNullObject | 返回预设条件条件格式。 | |
| 优先权 | 此条件格式当前存在于的条件格式集合中的优先级 (或索引) 。 | |
| stopIfTrue | 如果满足此条件格式的条件，则不会有任何低优先级格式应在此单元格上生效。 | |
| textComparison | 如果当前条件格式是文本类型，则返回特定的文本条件格式属性。 | |
| textComparisonOrNullObject | 如果当前条件格式是文本类型，则返回特定的文本条件格式属性。 | |
| topBottom | 如果当前条件格式是类型 TopBottom ，则返回顶部/底部的条件格式属性。 |
|
| topBottomOrNullObject | 如果当前条件格式是类型 TopBottom ，则返回顶部/底部的条件格式属性。 |
|
| type | 条件格式的类型。 | |
| ConditionalFormatCollection | 添加 (类型：Excel.ConditionalFormatType) | 将新的条件格式添加到集合的第一个/最高优先级。 |
| clearAll () | 清除当前指定区域中处于活动状态的所有条件格式。 | |
| getCount() | 返回工作簿中条件格式的数目。 | |
| getItem(id: string) | 返回给定 ID 的条件格式。 | |
| getItemAt(index: number) | 返回给定索引处的条件格式。 | |
| items | 获取此集合中已加载的子项。 | |
| ConditionalFormatRule | formula | 计算条件格式规则的公式（如果需要）。 |
| formulaLocal | 计算用户语言条件格式规则的公式（如果需要）。 | |
| formulaR1C1 | 计算 R1C1 样式表示法中条件格式规则的公式（如果需要）。 | |
| ConditionalIconCriterion | customIcon | 如果与默认图标集不同，则返回当前条件的自定义图标，否则 null 将返回。 |
| formula | 取决于类型的数字或公式。 | |
| operator |
greaterThan 或 greaterThanOrEqual 对于图标条件格式的每个规则类型。 |
|
| type | 应基于的图标条件公式。 | |
| ConditionalPresetCriteriaRule | 标准 | 条件格式的条件。 |
| ConditionalRangeBorder | color | 表示边框线颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“橙色”) 。 |
| sideIndex | 指示边框的特定边的常量值。 | |
| style | 线条样式的常量之一，指定边框的线条样式。 | |
| ConditionalRangeBorderCollection | bottom | 获取下边框。 |
| count | 集合中的 border 对象数量。 | |
| getItem (index：Excel.ConditionalRangeBorderIndex) | 使用其名称获取 border 对象 | |
| getItemAt(index: number) | 使用其索引获取 border 对象 | |
| items | 获取此集合中已加载的子项。 | |
| left | 获取左边框。 | |
| right | 获取右边框。 | |
| top | 获取上边框。 | |
| ConditionalRangeFill | clear() | 重置填充。 |
| color | 表示填充颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名 HTML 颜色 (，例如“橙色”) 。 | |
| ConditionalRangeFont | bold | 指定字体是否为粗体。 |
| clear() | 重置字体格式。 | |
| color | 文本颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。 | |
| italic | 指定字体是否为斜体。 | |
| strikethrough | 指定字体的删除线状态。 | |
| underline | 应用于字体的下划线类型。 | |
| ConditionalRangeFormat | Borders | 应用于整体条件格式范围的边框对象的集合。 |
| fill | 返回在总体条件格式范围上定义的填充对象。 | |
| font | 返回在总体条件格式范围上定义的字体对象。 | |
| numberFormat | 表示给定区域的 Excel 数字格式代码。 | |
| ConditionalTextComparisonRule | operator | 文本条件格式的运算符。 |
| text | 条件格式的文本值。 | |
| ConditionalTopBottomRule | rank | 1 和 1000 之间的数字排名或 1 和 100 之间的百分比排名。 |
| type | 根据排名靠前或下一级设置值的格式。 | |
| CustomConditionalFormat | format | 返回格式对象，该对象封装条件格式字体、填充、边框和其他属性。 |
| 统治 | 指定 Rule 此条件格式上的 对象。 |
|
| DataBarConditionalFormat | axisColor | 表示轴线颜色的 HTML 颜色代码，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“橙色”) 。 |
| axisFormat | 如何为 Excel 数据栏确定轴的表示形式。 | |
| barDirection | 指定数据条图形应基于的方向。 | |
| lowerBoundRule | 有关构成下限 (以及如何计算下限的规则（如果适用），) 数据条。 | |
| negativeFormat | Excel 数据栏中轴左侧所有值的表示形式。 | |
| positiveFormat | Excel 数据栏中轴右侧所有值的表示形式。 | |
| showDataBarOnly | 如果 true为 ，则隐藏应用数据条的单元格中的值。 |
|
| upperBoundRule | 构成数据栏的上限（以及如何计算，如果适用）的规则。 | |
| IconSetConditionalFormat | criteria | 规则的条件和图标集的数组，条件图标的潜在自定义图标。 |
| reverseIconOrder | 如果 true为 ，则反转图标集的图标顺序。 |
|
| showIconOnly | 如果 true为 ，则隐藏值并仅显示图标。 |
|
| style | 如果已设置，则显示条件格式的图标集选项。 | |
| PresetCriteriaConditionalFormat | format | 返回格式对象，该对象封装条件格式字体、填充、边框和其他属性。 |
| 统治 | 条件格式的规则。 | |
| 区域 | calculate() | 计算工作表上的单元格区域。 |
| conditionalFormats | 与范围相交的 的 集合 ConditionalFormats 。 |
|
| TextConditionalFormat | format | 返回格式对象，该对象封装条件格式的字体、填充、边框和其他属性。 |
| 统治 | 条件格式的规则。 | |
| TopBottomConditionalFormat | format | 返回格式对象，该对象封装条件格式的字体、填充、边框和其他属性。 |
| 统治 | 顶部/底部条件格式的条件。 | |
| Worksheet | calculate (markAllDirty： boolean) | 计算工作表上的所有单元格。 |