ExcelScript.TopBottomConditionalFormat interface

Представляет верхнее или нижнее условное форматирование.

Методы

getFormat()

Возвращает объект Format, инкапсулирующий шрифт, заливку, границы и другие свойства условного форматирования.

getRule()

Критерии условного форматирования Top/Bottom.

setRule(rule)

Критерии условного форматирования Top/Bottom.

Сведения о методе

getFormat()

Возвращает объект Format, инкапсулирующий шрифт, заливку, границы и другие свойства условного форматирования.

getFormat(): ConditionalRangeFormat;

Возвращаемое значение

getRule()

Критерии условного форматирования Top/Bottom.

getRule(): ConditionalTopBottomRule;

Возвращаемое значение

setRule(rule)

Критерии условного форматирования Top/Bottom.

setRule(rule: ConditionalTopBottomRule): void;

Параметры

Возвращаемое значение

void

Примеры

/**
 * This sample applies conditional formatting to the currently used range in the worksheet. 
 * The conditional formatting is a green fill for the top 10% of values.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get the used range in the worksheet.
  let range = selectedSheet.getUsedRange();

  // Set the fill color to green for the top 10% of values in the range.
  let conditionalFormat = range.addConditionalFormat(ExcelScript.ConditionalFormatType.topBottom)
  conditionalFormat.getTopBottom().getFormat().getFill().setColor("green");
  conditionalFormat.getTopBottom().setRule({
    rank: 10, // The percentage threshold.
    type: ExcelScript.ConditionalTopBottomCriterionType.topPercent // The type of the top/bottom condition.
  });
}