ExcelScript.ConditionalIconCriterion 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);

  // Use the "3 Traffic Lights (Unrimmed)" set.
  conditionalFormatting.getIconSet().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.
  const criteria: ExcelScript.ConditionalIconCriterion[] = [
    {
      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
    }];
  conditionalFormatting.getIconSet().setCriteria(criteria);
}

Свойства

customIcon

Пользовательский значок для текущего критерия, если он отличается от установленного по умолчанию значка, в противном случае null будет возвращен.
formula

Число или формула в зависимости от типа.
operator

greaterThan или greaterThanOrEqual для каждого из типов правил условного формата значка.
type

На чем должна основываться условная формула значка.

Сведения о свойстве

customIcon

Пользовательский значок для текущего критерия, если он отличается от установленного по умолчанию значка, в противном случае null будет возвращен.

customIcon?: Icon;

Значение свойства

ExcelScript.Icon

formula

Число или формула в зависимости от типа.

formula: string;

Значение свойства

string

operator

greaterThan или greaterThanOrEqual для каждого из типов правил условного формата значка.

operator: ConditionalIconCriterionOperator;

Значение свойства

ExcelScript.ConditionalIconCriterionOperator

type

На чем должна основываться условная формула значка.

type: ConditionalFormatIconRuleType;

Значение свойства

ExcelScript.ConditionalFormatIconRuleType