ExcelScript.ConditionalRangeFormat interface

Paket:

ExcelScript

Ein Formatobjekt, das die Schriftart, Füllung, Rahmen und andere Eigenschaften des bereichsbedingte Formate einkapselt.

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();
  format.getFill().setColor("yellow");
  format.getFont().setItalic(true);
}

Methoden

getBorders()	Auflistung von Rahmenobjekten, die für den gesamten bedingten Formatbereich gelten.
getConditionalRangeBorder(index)	Ruft ein Rahmen-Objekt ab, das den Namen verwendet
getConditionalRangeBorderBottom()	Ruft den unteren Rahmen ab.
getConditionalRangeBorderLeft()	Ruft den linken Rahmen ab.
getConditionalRangeBorderRight()	Ruft den rechten Rahmen ab.
getConditionalRangeBorderTop()	Ruft den oberen Rahmen ab.
getFill()	Gibt das Füllobjekt zurück, das für den gesamten bedingten Formatbereich definiert ist.
getFont()	Gibt das Schriftartobjekt zurück, das für den allgemeinen bedingten Formatbereich definiert ist.
getNumberFormat()	Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Wird gelöscht, wenn null übergeben wird.
setNumberFormat(numberFormat)	Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Wird gelöscht, wenn null übergeben wird.

Details zur Methode

getBorders()

Auflistung von Rahmenobjekten, die für den gesamten bedingten Formatbereich gelten.

getBorders(): ConditionalRangeBorder[];

Gibt zurück

ExcelScript.ConditionalRangeBorder[]

getConditionalRangeBorder(index)

Ruft ein Rahmen-Objekt ab, das den Namen verwendet

getConditionalRangeBorder(
            index: ConditionalRangeBorderIndex
        ): ConditionalRangeBorder;

Parameter

index

ExcelScript.ConditionalRangeBorderIndex

Index-Wert des abzurufenden Rahmen-Objekts. Weitere Informationen finden Sie unter ExcelScript.ConditionalRangeBorderIndex .

Gibt zurück

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderBottom()

Ruft den unteren Rahmen ab.

getConditionalRangeBorderBottom(): ConditionalRangeBorder;

Gibt zurück

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderLeft()

Ruft den linken Rahmen ab.

getConditionalRangeBorderLeft(): ConditionalRangeBorder;

Gibt zurück

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderRight()

Ruft den rechten Rahmen ab.

getConditionalRangeBorderRight(): ConditionalRangeBorder;

Gibt zurück

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderTop()

Ruft den oberen Rahmen ab.

getConditionalRangeBorderTop(): ConditionalRangeBorder;

Gibt zurück

ExcelScript.ConditionalRangeBorder

getFill()

Gibt das Füllobjekt zurück, das für den gesamten bedingten Formatbereich definiert ist.

getFill(): ConditionalRangeFill;

Gibt zurück

ExcelScript.ConditionalRangeFill

getFont()

Gibt das Schriftartobjekt zurück, das für den allgemeinen bedingten Formatbereich definiert ist.

getFont(): ConditionalRangeFont;

Gibt zurück

ExcelScript.ConditionalRangeFont

getNumberFormat()

Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Wird gelöscht, wenn null übergeben wird.

getNumberFormat(): string;

Gibt zurück

string

setNumberFormat(numberFormat)

Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Wird gelöscht, wenn null übergeben wird.

setNumberFormat(numberFormat: string): void;

Parameter

numberFormat

string

Gibt zurück

void