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