ExcelScript.ConditionalFormatRule interface

Paket:

ExcelScript

Stellt eine Regel für alle herkömmlichen Regel-/Formatpaare dar.

Hinweise

Beispiele

/**
 * This script applies a custom conditional formatting to the selected range.
 * A light-green fill is applied to a cell if the value is larger than the value in the row's previous column.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the selected cells.
  let selectedRange = workbook.getSelectedRange();

  // Apply a rule for positive change from the previous column.
  let positiveChange: ExcelScript.ConditionalFormat = selectedRange.addConditionalFormat(ExcelScript.ConditionalFormatType.custom);

  // Set the conditional format to be a lightgreen fill.
  let positiveCustom: ExcelScript.CustomConditionalFormat = positiveChange.getCustom();
  positiveCustom.getFormat().getFill().setColor("lightgreen");

  // Set the conditional rule to be if there is positive change across the row.
  let positiveRule: ExcelScript.ConditionalFormatRule = positiveCustom.getRule();
  positiveRule.setFormula(`=${selectedRange.getCell(0, 0).getAddress()}>${selectedRange.getOffsetRange(0, -1).getCell(0, 0).getAddress()}`);
}

Methoden

getFormula()	Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.
getFormulaLocal()	Die Formel, falls erforderlich, für die die Regel für das bedingte Format in der Sprache des Benutzers ausgewertet werden soll.
setFormula(formula)	Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.
setFormulaLocal(formulaLocal)	Die Formel, falls erforderlich, für die die Regel für das bedingte Format in der Sprache des Benutzers ausgewertet werden soll.

Details zur Methode

getFormula()

Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.

getFormula(): string;

Gibt zurück

string

getFormulaLocal()

Die Formel, falls erforderlich, für die die Regel für das bedingte Format in der Sprache des Benutzers ausgewertet werden soll.

getFormulaLocal(): string;

Gibt zurück

string

setFormula(formula)

Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.

setFormula(formula: string): void;

Parameter

formula

string

Gibt zurück

void

setFormulaLocal(formulaLocal)

Die Formel, falls erforderlich, für die die Regel für das bedingte Format in der Sprache des Benutzers ausgewertet werden soll.

setFormulaLocal(formulaLocal: string): void;

Parameter

formulaLocal

string

Gibt zurück

void