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