FormatCondition类
FormatCondition类
表示条件格式化条件。
FormatCondition 类型公开以下成员:
特性
属性 | 描述 |
---|---|
formula1 | 获取和设置与条件格式关联的值或表达式。 |
formula2 | 获取和设置与条件格式关联的值或表达式。 |
operator | 获取和设置条件格式运算符类型。 |
stop_if_true | 确实如此,当此规则评估为 true 时,任何优先级较低的规则都不能应用于此规则。 仅适用于Excel 2007; |
priority | 此条件格式规则的优先级。该值用于确定哪个 格式应该被评估和渲染。较小的数值优先级高于 更高的数值,其中“1”是最高优先级。 |
style | 获取或设置条件格式化单元格范围的样式。 |
type | 获取和设置条件格式是否为Type。 |
icon_set | 获取条件格式的“IconSet”实例。 默认实例的 IconSetType 是 TrafficLights31。 仅对 type = IconSet 有效。 |
data_bar | 获取条件格式的“DataBar”实例。 默认实例的颜色是蓝色。 仅对 DataBar 类型有效。 |
color_scale | 获取条件格式的“ColorScale”实例。 默认实例是“绿-黄-红”3ColorScale 。 仅对类型 = ColorScale 有效。 |
top10 | 获取条件格式的“Top10”实例。 默认实例的规则突出显示其 值落在前 10 名括号内。 仅对类型为 Top10 有效。 |
above_average | 获取条件格式的“AboveAverage”实例。 默认实例的规则突出显示以下单元格 高于该范围内所有值的平均值。 仅对类型=AboveAverage 有效。 |
text | “文本包含”条件格式设置规则中的文本值。 仅对 type = containsText、notContainsText、beginsWith 和endsWith 有效。 默认值为空。 |
time_period | “发生日期…”条件格式规则中的适用时间段。 仅对 type = timePeriod 有效。 默认值为 TimePeriodType.Today。 |
方法
方法 | 描述 |
---|---|
get_formula1 | 获取与此格式条件关联的值或表达式。 |
get_formula1 | 获取单元格条件格式的值或表达式。 |
get_formula1 | 获取单元格条件格式的公式。 |
get_formula2 | 获取与此格式条件关联的值或表达式。 |
get_formula2 | 获取单元格条件格式的值或表达式。 |
get_formula2 | 获取单元格条件格式的公式。 |
set_formulas | 设置与此格式条件关联的值或表达式。 |
set_formula1 | 设置与此格式条件关联的值或表达式。 |
set_formula2 | 设置与此格式条件关联的值或表达式。 |
例子
from aspose.cells import CellArea, FormatConditionType, OperatorType, Workbook
from aspose.pydrawing import Color
# Instantiating a Workbook object
workbook = Workbook()
sheet = workbook.worksheets[0]
# Adds an empty conditional formatting
index = sheet.conditional_formattings.add()
fcs = sheet.conditional_formattings[index]
# Sets the conditional format range.
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
fcs.add_area(ca)
ca = CellArea()
ca.start_row = 1
ca.end_row = 1
ca.start_column = 1
ca.end_column = 1
fcs.add_area(ca)
# Adds condition.
conditionIndex = fcs.add_condition(FormatConditionType.CELL_VALUE, OperatorType.BETWEEN, "=A2", "100")
# Adds condition.
conditionIndex2 = fcs.add_condition(FormatConditionType.CELL_VALUE, OperatorType.BETWEEN, "50", "100")
# Sets the background color.
fc = fcs[conditionIndex]
fc.style.background_color = Color.red
# Saving the Excel file
workbook.save("output.xls")