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