通过

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) 计算工作表上的所有单元格。

另请参阅