ExcelScript.ConditionalFormatRule interface

包:

ExcelScript

表示所有传统规则/格式配对的规则。

注解

示例

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

方法

getFormula()	计算条件格式规则的公式（如果需要）。
getFormulaLocal()	计算用户语言条件格式规则的公式（如果需要）。
setFormula(formula)	计算条件格式规则的公式（如果需要）。
setFormulaLocal(formulaLocal)	计算用户语言条件格式规则的公式（如果需要）。

方法详细信息

getFormula()

计算条件格式规则的公式（如果需要）。

getFormula(): string;

返回

string

getFormulaLocal()

计算用户语言条件格式规则的公式（如果需要）。

getFormulaLocal(): string;

返回

string

setFormula(formula)

计算条件格式规则的公式（如果需要）。

setFormula(formula: string): void;

参数

formula

string

返回

void

setFormulaLocal(formulaLocal)

计算用户语言条件格式规则的公式（如果需要）。

setFormulaLocal(formulaLocal: string): void;

参数

formulaLocal

string

返回

void