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