IIconCriterion

Interface IIconCriterion

public interface IIconCriterion

表示图标集中单个图标的条件。

该条件指定图标集条件格式规则中与图标关联的值范围和阈值类型。每个 IIconCriterion 都为一个图标定义阈值设置，包括其图标、比较运算符、阈值类型、阈值和在图标集中的位置。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setType(ConditionValueTypes.Number);
 criterion.setValue(50);

Method Summary

Modifier and Type

Method

Description

IconType

getIcon()

获取分配给此条件的 IconType 值。

int

getIndex()

获取此条件在其父 IIconCriteria 集合中的从零开始的索引。

FormatConditionOperator

getOperator()

返回 FormatConditionOperator 枚举的一个常量，该常量指定阈值是“大于”还是“大于或等于”阈值。

ConditionValueTypes

getType()

返回 ConditionValueTypes 枚举的一个常量，该常量指定如何确定图标集的阈值。

Object

getValue()

获取条件格式中图标的阈值。

void

setIcon(IconType value)

设置此条件的 IconType 值。

void

setOperator(FormatConditionOperator value)

设置 FormatConditionOperator 枚举的一个常量，该常量指定阈值是大于还是大于或等于阈值。

void

setType(ConditionValueTypes value)

设置 ConditionValueTypes 枚举的一个常量，该常量指定如何确定图标集的阈值。

void

setValue(Object value)

设置此图标条件的阈值。

Method Details

getIcon

IconType getIcon()

获取分配给此条件的 IconType 值。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 IconType icon = criterion.getIcon();

Returns:: 分配的 IconType 值。

setIcon

void setIcon(IconType value)

设置此条件的 IconType 值。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setIcon(IconType.RedCross);

Parameters:: value - 要分配的 IconType 值。

getIndex

int getIndex()

获取此条件在其父 IIconCriteria 集合中的从零开始的索引。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 int index = criterion.getIndex();

Returns:: 从零开始的条件索引。

getOperator

FormatConditionOperator getOperator()
返回 FormatConditionOperator 枚举的一个常量，该常量指定阈值是“大于”还是“大于或等于”阈值。
对于图标集条件格式规则，返回的值指示此条件如何将单元格值与其阈值比较。
```
 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setOperator(FormatConditionOperator.GreaterEqual);
 FormatConditionOperator operator = criterion.getOperator();
 
```
Returns:

此图标条件的阈值比较运算符。通常为 FormatConditionOperator.Greater 或FormatConditionOperator.GreaterEqual。
setOperator

void setOperator(FormatConditionOperator value)
设置 FormatConditionOperator 枚举的一个常量，该常量指定阈值是大于还是大于或等于阈值。
对于图标集条件格式规则，此属性只能设置为 FormatConditionOperator.Greater 或 FormatConditionOperator.GreaterEqual。
```
 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setOperator(FormatConditionOperator.GreaterEqual);
 
```
Parameters:

value - 图标阈值的比较运算符。使用FormatConditionOperator.Greater 或FormatConditionOperator.GreaterEqual。
getType

ConditionValueTypes getType()
返回 ConditionValueTypes 枚举的一个常量，该常量指定如何确定图标集的阈值。
使用此方法可以检查条件阈值被解释为数字、百分比、百分位数、公式还是其他受支持的条件值类型。
```
 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setType(ConditionValueTypes.Percent);
 ConditionValueTypes type = criterion.getType();
 
```
Returns:

ConditionValueTypes 枚举的一个常量，指示如何确定图标条件的阈值。

setType

void setType(ConditionValueTypes value)

设置 ConditionValueTypes 枚举的一个常量，该常量指定如何确定图标集的阈值。

使用此方法可以控制图标条件如何解释其阈值，例如固定数值、百分比、百分位数、公式，或基于区域的最小值或最大值。


 worksheet.getRange("A1:A5").setValue(new Object[][] {{10}, {30}, {50}, {70}, {90}});
 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setType(ConditionValueTypes.Percent);
 criterion.setValue(60);

Parameters:: value - 指定如何确定图标条件阈值的 ConditionValueTypes 常量。

getValue

Object getValue()

获取条件格式中图标的阈值。

返回的值对应为此图标条件配置的阈值，例如数字、百分比、百分位数或公式值，具体取决于条件类型。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setType(ConditionValueTypes.Percent);
 criterion.setValue(50);
 Object value = criterion.getValue();

Returns:: 图标条件的阈值。

setValue

void setValue(Object value)

设置此图标条件的阈值。

指定值根据当前 ConditionValueTypes 进行解释；配置阈值时应先设置类型，再设置值。


 IIconSetCondition condition = worksheet.getRange("A1:A5").getFormatConditions().addIconSetCondition();
 condition.setIconSet(workbook.getIconSets().get(IconSetType.Icon3Symbols));
 IIconCriterion criterion = condition.getIconCriteria().get(1);
 criterion.setType(ConditionValueTypes.Percent);
 criterion.setValue(50);

Parameters:: value - 要设置的阈值。

IIconCriterion

Interface IIconCriterion

Method Summary