ExcelScript.WorkbookRangeAreas interface

Представляет коллекцию из одного или нескольких прямоугольных диапазонов на нескольких листах.

Комментарии

Примеры

/**
 * This script finds the direct precedents of the active cell.
 * It changes the font and color of those precedent cells. 
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the active cell.
  const selected = workbook.getActiveCell();
  
  // Get the cells that are direct precedents of the current cell.
  const precedents : ExcelScript.WorkbookRangeAreas = selected.getDirectPrecedents();

  // Set the font to bold and the fill color to orange for all the precedent cells.
  precedents.getRanges().forEach(range => {
    range.getFormat().getFill().setColor("orange");
    range.getFormat().getFont().setBold(true);
  });
}

Методы

getAddresses()

Возвращает массив адресов в стиле A1. Значения адресов содержат имя листа для каждого прямоугольного блока ячеек (например, "Лист1! A1:B4, Лист1! D1:D4"). Только для чтения.

getAreas()

RangeAreasCollection Возвращает объект . Каждый из них RangeAreas в коллекции представляет один или несколько диапазонов прямоугольника на одном листе.

getRangeAreasBySheet(key)

Возвращает объект на RangeAreas основе имени листа или идентификатора в коллекции. Если лист не существует, этот метод возвращает undefined.

getRanges()

Возвращает диапазоны, составляющие этот объект в объекте RangeCollection .

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

getAddresses()

Возвращает массив адресов в стиле A1. Значения адресов содержат имя листа для каждого прямоугольного блока ячеек (например, "Лист1! A1:B4, Лист1! D1:D4"). Только для чтения.

getAddresses(): string[];

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

string[]

getAreas()

RangeAreasCollection Возвращает объект . Каждый из них RangeAreas в коллекции представляет один или несколько диапазонов прямоугольника на одном листе.

getAreas(): RangeAreas[];

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

getRangeAreasBySheet(key)

Возвращает объект на RangeAreas основе имени листа или идентификатора в коллекции. Если лист не существует, этот метод возвращает undefined.

getRangeAreasBySheet(key: string): RangeAreas;

Параметры

key

string

Имя или идентификатор листа.

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

getRanges()

Возвращает диапазоны, составляющие этот объект в объекте RangeCollection .

getRanges(): Range[];

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