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);
});
}
Методы
get |
Возвращает массив адресов в стиле A1. Значения адресов содержат имя листа для каждого прямоугольного блока ячеек (например, "Лист1! A1:B4, Лист1! D1:D4"). Только для чтения. |
get |
|
get |
Возвращает объект на |
get |
Возвращает диапазоны, составляющие этот объект в объекте |
Сведения о методе
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[];
Возвращаемое значение
Office Scripts