Freigeben über


ExcelScript.ConditionalRangeFill interface

Stellt den Hintergrund eines bedingten Bereichsobjekts dar.

Hinweise

Beispiele

/**
 * This script applies cell value conditional formatting to a range.
 * Any value less than 60 will have the cell's fill color changed and the font made italic.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range to format.
  const selectedRange = workbook.getSelectedRange();

  // Add cell value conditional formatting.
  const cellValueConditionalFormatting =
    selectedRange.addConditionalFormat(ExcelScript.ConditionalFormatType.cellValue).getCellValue();

  // Create the condition, in this case when the cell value is less than 60.
  const rule: ExcelScript.ConditionalCellValueRule = {
    formula1: "60",
    operator: ExcelScript.ConditionalCellValueOperator.lessThan
  };
  cellValueConditionalFormatting.setRule(rule);

  // Set the format to apply when the condition is met.
  const format: ExcelScript.ConditionalRangeFormat = cellValueConditionalFormatting.getFormat();
  const fill: ExcelScript.ConditionalRangeFill = format.getFill();
  const font: ExcelScript.ConditionalRangeFont = format.getFont();
  fill.setColor("yellow");
  font.setItalic(true);
}

Methoden

clear()

Setzt die Füllung zurück.

getColor()

HTML-Farbcode, der die Farbe der Füllung darstellt, im Formular #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "Orange").

setColor(color)

HTML-Farbcode, der die Farbe der Füllung darstellt, im Formular #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "Orange").

Details zur Methode

clear()

Setzt die Füllung zurück.

clear(): void;

Gibt zurück

void

getColor()

HTML-Farbcode, der die Farbe der Füllung darstellt, im Formular #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "Orange").

getColor(): string;

Gibt zurück

string

setColor(color)

HTML-Farbcode, der die Farbe der Füllung darstellt, im Formular #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "Orange").

setColor(color: string): void;

Parameter

color

string

Gibt zurück

void