Поделиться через

ExcelScript.NamedItem interface

Пакет:
ExcelScript

Представляет определенное имя для диапазона ячеек или значения. Имена могут быть примитивными именованными объектами (как показано в типе ниже), объектом диапазона или ссылкой на диапазон. Этот объект может использоваться для получения объекта диапазона, связанного с именами.

Замечания

Примеры

/**
 * This script creates a named formula and uses it in another part of the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a named item for a formula.
  // This formula is the sum of the cells F2:F21 on Sheet1.
  const namedItem: ExcelScript.NamedItem = workbook.addNamedItem(
    "GrandTotal", 
    "=SUM(Sheet1!$F$2:$F$21)", 
    "The sum of table sums."
  );

  // Add this named formula to a new sheet in the workbook.
  const otherSheet = workbook.addWorksheet();
  otherSheet.getRange("A1").setFormula(namedItem.getFormula());

  // Switch to the new worksheet.
  otherSheet.activate();
}

Методика

delete()

Удаляет заданное имя.
getArrayValues()

Возвращает объект, содержащий значения и типы именованного элемента.
getComment()

Указывает комментарий, связанный с этим именем.
getFormula()

Формула именованного элемента. Формулы всегда начинаются со знака равенства ("=").
getName()

Имя объекта.
getRange()

Возвращает объект Range, сопоставленный с именем. Если тип именованного элемента не является диапазоном, то этот метод возвращает undefined.
getScope()

Указывает, имеет ли имя область действия книги или определенного листа. Возможные значения: Лист, Книга.
getType()

Указывает тип значения, возвращаемого формулой имени. Дополнительные сведения см. в этой ExcelScript.NamedItemType статье.
getValue()

Представляет значение, вычисленное по формуле имени. Для именованного диапазона он вернет адрес диапазона. Этот API возвращает #VALUE! ошибка в пользовательском интерфейсе Excel, если она ссылается на определяемую пользователем функцию.
getVisible()

Указывает, является ли объект видимым.
getWorksheet()

Возвращает лист, для которого задана область именованного элемента. Если элемент ограничен книгой, то этот метод возвращает undefined.
setComment(comment)

Указывает комментарий, связанный с этим именем.
setFormula(formula)

Формула именованного элемента. Формулы всегда начинаются со знака равенства ("=").
setVisible(visible)

Указывает, является ли объект видимым.

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

delete()

Удаляет заданное имя.

delete(): void;

Возвращает

void

getArrayValues()

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

getArrayValues(): NamedItemArrayValues;

Возвращает

ExcelScript.NamedItemArrayValues

getComment()

Указывает комментарий, связанный с этим именем.

getComment(): string;

Возвращает

string

getFormula()

Формула именованного элемента. Формулы всегда начинаются со знака равенства ("=").

getFormula(): string;

Возвращает

string

getName()

Имя объекта.

getName(): string;

Возвращает

string

getRange()

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

getRange(): Range;

Возвращает

ExcelScript.Range

getScope()

Указывает, имеет ли имя область действия книги или определенного листа. Возможные значения: Лист, Книга.

getScope(): NamedItemScope;

Возвращает

ExcelScript.NamedItemScope

getType()

Указывает тип значения, возвращаемого формулой имени. Дополнительные сведения см. в этой ExcelScript.NamedItemType статье.

getType(): NamedItemType;

Возвращает

ExcelScript.NamedItemType

Примеры

/**
 * This script looks for every named range with "Review" in the name 
 * and marks the range with a yellow fill.
 */
function main(workbook: ExcelScript.Workbook) {
  // Look at every named item in the workbook.
  workbook.getNames().forEach((namedItem) => {
    // Find names containing "Review".
    if (namedItem.getName().includes("Review")) {
      // Only change the fill color if the named item is a range (not a formula).
      let itemType: ExcelScript.NamedItemType = namedItem.getType();
      if (itemType === ExcelScript.NamedItemType.range) {
        // Set the range's fill color to yellow.
        namedItem.getRange().getFormat().getFill().setColor("yellow");
      }
    }
  });
}

getValue()

Представляет значение, вычисленное по формуле имени. Для именованного диапазона он вернет адрес диапазона. Этот API возвращает #VALUE! ошибка в пользовательском интерфейсе Excel, если она ссылается на определяемую пользователем функцию.

getValue(): string | number;

Возвращает

string | number

getVisible()

Указывает, является ли объект видимым.

getVisible(): boolean;

Возвращает

boolean

getWorksheet()

Возвращает лист, для которого задана область именованного элемента. Если элемент ограничен книгой, то этот метод возвращает undefined.

getWorksheet(): Worksheet | undefined;

Возвращает

ExcelScript.Worksheet | undefined

setComment(comment)

Указывает комментарий, связанный с этим именем.

setComment(comment: string): void;

Параметры

comment

string

Возвращает

void

setFormula(formula)

Формула именованного элемента. Формулы всегда начинаются со знака равенства ("=").

setFormula(formula: string): void;

Параметры

formula

string

Возвращает

void

setVisible(visible)

Указывает, является ли объект видимым.

setVisible(visible: boolean): void;

Параметры

visible

boolean

Возвращает

void