FormatCondition

FormatCondition class

表示条件格式化条件。

public class FormatCondition

特性

姓名描述
AboveAverage { get; }获取条件格式的“AboveAverage”实例。 默认实例的规则突出显示范围内所有值高于平均值 的单元格。 仅对 type = AboveAverage 有效。
ColorScale { get; }获取条件格式的“ColorScale”实例。 默认实例是“green-yellow-red”3ColorScale . 仅对type = ColorScale有效。
DataBar { get; }获取条件格式的“DataBar”实例。 默认实例的颜色为蓝色。 仅对类型为DataBar有效。
Formula1 { get; set; }获取和设置与条件格式相关的值或表达式。
Formula2 { get; set; }获取和设置与条件格式相关的值或表达式。
IconSet { get; }获取条件格式的“IconSet”实例。 默认实例的IconSetType为TrafficLights31。 仅对type = IconSet有效。
Operator { get; set; }获取和设置条件格式运算符类型。
Priority { get; set; }此条件格式规则的优先级。此值用于确定应评估和呈现哪种 格式。较低的数值比 较高的数值具有更高的优先级，其中“1”是最高优先级。
StopIfTrue { get; set; }为真，当此规则计算结果为真时，不能应用优先级较低的规则。 仅适用于 Excel 2007；
Style { get; set; }获取或设置条件格式单元格范围的样式。
Text { get; set; }“文本包含”条件格式规则中的文本值。 仅对type = containsText、notContainsText、beginsWith和endsWith有效。 默认值为null。
TimePeriod { get; set; }“日期发生…”条件格式规则中的适用时间段。 仅对 type = timePeriod. 有效，默认值为 TimePeriodType.Today.
Top10 { get; }获取条件格式的“Top10”实例。 默认实例的规则突出显示 值位于前10个括号中的单元格。 仅对类型为Top10有效。
Type { get; set; }获取并设置是否条件格式Type.

方法

姓名描述
GetFormula1(bool, bool)获取与此格式条件关联的值或表达式。
GetFormula1(int, int)获取单元格条件格式的公式。
GetFormula1(bool, bool, int, int)获取单元格条件格式的值或表达式。
GetFormula2(bool, bool)获取与此格式条件关联的值或表达式。
GetFormula2(int, int)获取单元格条件格式的公式。
GetFormula2(bool, bool, int, int)获取单元格条件格式的值或表达式。
SetFormula1(string, bool, bool)设置与此格式条件关联的值或表达式。
SetFormula2(string, bool, bool)设置与此格式条件关联的值或表达式。
SetFormulas(string, string, bool, bool)设置与此格式条件关联的值或表达式。

例子


[C#]
//实例化一个工作簿对象
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
 
//添加一个空的条件格式
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
 
//设置条件格式范围。
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
 
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
 
//添加条件。
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
 
//添加条件。
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
 
//设置背景颜色。
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
 
//保存Excel文件
workbook.Save("output.xls");

[VB.NET]

'实例化工作簿对象
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
 
'添加一个空的条件格式
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
 
'设置条件格式范围。
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
 
'添加条件。
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
 
'添加条件。
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
 
'设置背景颜色。
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
 
'保存 Excel 文件
workbook.Save("output.xls")

也可以看看

FontUnderlineType FormatConditionCollection