ExcelScript.IconSetConditionalFormat interface

包:

ExcelScript

表示条件格式的图标集条件。

注解

示例

/**
 * This script applies icon set conditional formatting to a range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range "A1:A5" on the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const range = sheet.getRange("A1:A5");

  // Create icon set conditional formatting on the range.
  const conditionalFormatting = range.addConditionalFormat(ExcelScript.ConditionalFormatType.iconSet);
  const iconSetFormat: ExcelScript.IconSetConditionalFormat = conditionalFormatting.getIconSet();
  // Use the "3 Traffic Lights (Unrimmed)" set.
  iconSetFormat.setStyle(ExcelScript.IconSet.threeTrafficLights1);

  // Set the criteria to use a different icon for the bottom, middle, and top thirds of the values in the range.
  iconSetFormat.setCriteria([
    {
      formula:'=0',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent
    },
    {
      formula:'=33',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent},
    {
      formula:'=67',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent
    }]);
}

方法

getCriteria()	规则的条件和图标集的数组，条件图标的潜在自定义图标。 请注意，对于第一个条件，只能修改自定义图标，而类型、公式和运算符在设置时将被忽略。
getReverseIconOrder()	如果 true为 ，则反转图标集的图标顺序。 请注意，如果使用自定义图标，则无法设置此设置。
getShowIconOnly()	如果 true为 ，则隐藏值并仅显示图标。
getStyle()	如果已设置，则显示条件格式的图标集选项。
setCriteria(criteria)	规则的条件和图标集的数组，条件图标的潜在自定义图标。 请注意，对于第一个条件，只能修改自定义图标，而类型、公式和运算符在设置时将被忽略。
setReverseIconOrder(reverseIconOrder)	如果 true为 ，则反转图标集的图标顺序。 请注意，如果使用自定义图标，则无法设置此设置。
setShowIconOnly(showIconOnly)	如果 true为 ，则隐藏值并仅显示图标。
setStyle(style)	如果已设置，则显示条件格式的图标集选项。

方法详细信息

getCriteria()

规则的条件和图标集的数组，条件图标的潜在自定义图标。 请注意，对于第一个条件，只能修改自定义图标，而类型、公式和运算符在设置时将被忽略。

getCriteria(): ConditionalIconCriterion[];

返回

ExcelScript.ConditionalIconCriterion[]

getReverseIconOrder()

如果 true为 ，则反转图标集的图标顺序。 请注意，如果使用自定义图标，则无法设置此设置。

getReverseIconOrder(): boolean;

返回

boolean

getShowIconOnly()

如果 true为 ，则隐藏值并仅显示图标。

getShowIconOnly(): boolean;

返回

boolean

getStyle()

如果已设置，则显示条件格式的图标集选项。

getStyle(): IconSet;

返回

ExcelScript.IconSet

setCriteria(criteria)

规则的条件和图标集的数组，条件图标的潜在自定义图标。 请注意，对于第一个条件，只能修改自定义图标，而类型、公式和运算符在设置时将被忽略。

setCriteria(criteria: ConditionalIconCriterion[]): void;

参数

criteria

ExcelScript.ConditionalIconCriterion[]

返回

void

setReverseIconOrder(reverseIconOrder)

如果 true为 ，则反转图标集的图标顺序。 请注意，如果使用自定义图标，则无法设置此设置。

setReverseIconOrder(reverseIconOrder: boolean): void;

参数

reverseIconOrder

boolean

返回

void

setShowIconOnly(showIconOnly)

如果 true为 ，则隐藏值并仅显示图标。

setShowIconOnly(showIconOnly: boolean): void;

参数

showIconOnly

boolean

返回

void

setStyle(style)

如果已设置，则显示条件格式的图标集选项。

setStyle(style: IconSet): void;

参数

style

ExcelScript.IconSet

返回

void