ExcelScript.IconSetConditionalFormat interface

Paket:

ExcelScript

Stellt ein Symbolsatzkriterium für die bedingte Formatierung dar.

Hinweise

Beispiele

/**
 * 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
    }]);
}

Methoden

getCriteria()	Ein Array von Kriterien und Symbolsätzen für die Regeln und potenzielle benutzerdefinierte Symbole für bedingte Symbole. Beachten Sie, dass für das erste Kriterium nur das benutzerdefinierte Symbol geändert werden kann, während Typ, Formel und Operator beim Festlegen ignoriert werden.
getReverseIconOrder()	Gibt truean, dass die Symbolreihenfolgen für den Symbolsatz umgekehrt werden. Beachten Sie, dass dies nicht festgelegt werden kann, wenn benutzerdefinierte Symbole verwendet werden.
getShowIconOnly()	Bei truewerden die Werte ausgeblendet und nur Symbole angezeigt.
getStyle()	Wenn festgelegt, wird die Symbolsatzoption für das bedingte Format angezeigt.
setCriteria(criteria)	Ein Array von Kriterien und Symbolsätzen für die Regeln und potenzielle benutzerdefinierte Symbole für bedingte Symbole. Beachten Sie, dass für das erste Kriterium nur das benutzerdefinierte Symbol geändert werden kann, während Typ, Formel und Operator beim Festlegen ignoriert werden.
setReverseIconOrder(reverseIconOrder)	Gibt truean, dass die Symbolreihenfolgen für den Symbolsatz umgekehrt werden. Beachten Sie, dass dies nicht festgelegt werden kann, wenn benutzerdefinierte Symbole verwendet werden.
setShowIconOnly(showIconOnly)	Bei truewerden die Werte ausgeblendet und nur Symbole angezeigt.
setStyle(style)	Wenn festgelegt, wird die Symbolsatzoption für das bedingte Format angezeigt.

Details zur Methode

getCriteria()

Ein Array von Kriterien und Symbolsätzen für die Regeln und potenzielle benutzerdefinierte Symbole für bedingte Symbole. Beachten Sie, dass für das erste Kriterium nur das benutzerdefinierte Symbol geändert werden kann, während Typ, Formel und Operator beim Festlegen ignoriert werden.

getCriteria(): ConditionalIconCriterion[];

Gibt zurück

ExcelScript.ConditionalIconCriterion[]

getReverseIconOrder()

Gibt truean, dass die Symbolreihenfolgen für den Symbolsatz umgekehrt werden. Beachten Sie, dass dies nicht festgelegt werden kann, wenn benutzerdefinierte Symbole verwendet werden.

getReverseIconOrder(): boolean;

Gibt zurück

boolean

getShowIconOnly()

Bei truewerden die Werte ausgeblendet und nur Symbole angezeigt.

getShowIconOnly(): boolean;

Gibt zurück

boolean

getStyle()

Wenn festgelegt, wird die Symbolsatzoption für das bedingte Format angezeigt.

getStyle(): IconSet;

Gibt zurück

ExcelScript.IconSet

setCriteria(criteria)

Ein Array von Kriterien und Symbolsätzen für die Regeln und potenzielle benutzerdefinierte Symbole für bedingte Symbole. Beachten Sie, dass für das erste Kriterium nur das benutzerdefinierte Symbol geändert werden kann, während Typ, Formel und Operator beim Festlegen ignoriert werden.

setCriteria(criteria: ConditionalIconCriterion[]): void;

Parameter

criteria

ExcelScript.ConditionalIconCriterion[]

Gibt zurück

void

setReverseIconOrder(reverseIconOrder)

Gibt truean, dass die Symbolreihenfolgen für den Symbolsatz umgekehrt werden. Beachten Sie, dass dies nicht festgelegt werden kann, wenn benutzerdefinierte Symbole verwendet werden.

setReverseIconOrder(reverseIconOrder: boolean): void;

Parameter

reverseIconOrder

boolean

Gibt zurück

void

setShowIconOnly(showIconOnly)

Bei truewerden die Werte ausgeblendet und nur Symbole angezeigt.

setShowIconOnly(showIconOnly: boolean): void;

Parameter

showIconOnly

boolean

Gibt zurück

void

setStyle(style)

Wenn festgelegt, wird die Symbolsatzoption für das bedingte Format angezeigt.

setStyle(style: IconSet): void;

Parameter

style

ExcelScript.IconSet

Gibt zurück

void