ExcelScript.ConditionalRangeFormat interface

Пакет:

ExcelScript

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

Замечания

Примеры

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

Методика

clearFormat()	Удалите свойства формата из правила условного формата. При этом будет создано правило без параметров формата.
getBorders()	Коллекция объектов границы, которые применяются к общему диапазону условного формата.
getConditionalRangeBorder(index)	Возвращает объект границы по его имени.
getConditionalRangeBorderBottom()	Возвращает нижнюю границу.
getConditionalRangeBorderLeft()	Возвращает левую границу.
getConditionalRangeBorderRight()	Возвращает правильную границу.
getConditionalRangeBorderTop()	Возвращает верхнюю границу.
getFill()	Возвращает объект заполнения, определенный в общем диапазоне условного формата.
getFont()	Возвращает объект шрифта, определенный в общем диапазоне условного формата.
getNumberFormat()	Представляет код числового формата Excel для заданного диапазона. Очищается, если null передается.
setNumberFormat(numberFormat)	Представляет код числового формата Excel для заданного диапазона. Очищается, если null передается.

Подробнее о методе

clearFormat()

Удалите свойства формата из правила условного формата. При этом будет создано правило без параметров формата.

clearFormat(): void;

Возвращает

void

getBorders()

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

getBorders(): ConditionalRangeBorder[];

Возвращает

ExcelScript.ConditionalRangeBorder[]

getConditionalRangeBorder(index)

Возвращает объект границы по его имени.

getConditionalRangeBorder(
            index: ConditionalRangeBorderIndex
        ): ConditionalRangeBorder;

Параметры

index

ExcelScript.ConditionalRangeBorderIndex

Значение индекса получаемого объекта границы. Дополнительные сведения см. в этой ExcelScript.ConditionalRangeBorderIndex статье.

Возвращает

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderBottom()

Возвращает нижнюю границу.

getConditionalRangeBorderBottom(): ConditionalRangeBorder;

Возвращает

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderLeft()

Возвращает левую границу.

getConditionalRangeBorderLeft(): ConditionalRangeBorder;

Возвращает

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderRight()

Возвращает правильную границу.

getConditionalRangeBorderRight(): ConditionalRangeBorder;

Возвращает

ExcelScript.ConditionalRangeBorder

getConditionalRangeBorderTop()

Возвращает верхнюю границу.

getConditionalRangeBorderTop(): ConditionalRangeBorder;

Возвращает

ExcelScript.ConditionalRangeBorder

getFill()

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

getFill(): ConditionalRangeFill;

Возвращает

ExcelScript.ConditionalRangeFill

getFont()

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

getFont(): ConditionalRangeFont;

Возвращает

ExcelScript.ConditionalRangeFont

getNumberFormat()

Представляет код числового формата Excel для заданного диапазона. Очищается, если null передается.

getNumberFormat(): string;

Возвращает

string

setNumberFormat(numberFormat)

Представляет код числового формата Excel для заданного диапазона. Очищается, если null передается.

setNumberFormat(numberFormat: string): void;

Параметры

numberFormat

string

Возвращает

void