ExcelScript.CellValueConditionalFormat interface

Paket:

ExcelScript

Stellt ein bedingtes Zellwertformat dar.

Hinweise

Beispiele

/**
 * This script applies conditional formatting to a range.
 * That formatting is conditional upon the cell's numerical value.
 * Any value between 50 and 75 will have the cell fill color changed and the font made italic.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range to format.
  const sheet = workbook.getActiveWorksheet();
  const ratingColumn = sheet.getRange("D2:D20");

  // Add cell value conditional formatting.
  const cellValueConditionalFormatting : ExcelScript.CellValueConditionalFormat 
    = ratingColumn.addConditionalFormat(ExcelScript.ConditionalFormatType.cellValue).getCellValue();
  
  // Create the condition, in this case when the cell value is between 50 and 75.
  let rule: ExcelScript.ConditionalCellValueRule = {
    formula1: "50",
    formula2: "75",
    operator: ExcelScript.ConditionalCellValueOperator.between
  };
  cellValueConditionalFormatting.setRule(rule);

  // Set the format to apply when the condition is met.
  let format = cellValueConditionalFormatting.getFormat();
  format.getFill().setColor("yellow");
  format.getFont().setItalic(true);
}

Methoden

getFormat()	Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen und andere Eigenschaften für bedingte Formate kapselt.
getRule()	Gibt das Regelobjekt für dieses bedingte Format an.
setRule(rule)	Gibt das Regelobjekt für dieses bedingte Format an.

Details zur Methode

getFormat()

Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen und andere Eigenschaften für bedingte Formate kapselt.

getFormat(): ConditionalRangeFormat;

Gibt zurück

ExcelScript.ConditionalRangeFormat

getRule()

Gibt das Regelobjekt für dieses bedingte Format an.

getRule(): ConditionalCellValueRule;

Gibt zurück

ExcelScript.ConditionalCellValueRule

setRule(rule)

Gibt das Regelobjekt für dieses bedingte Format an.

setRule(rule: ConditionalCellValueRule): void;

Parameter

rule

ExcelScript.ConditionalCellValueRule

Gibt zurück

void