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