Определяет новое имя. Возвращает интерфейс
IXLSName
Синтаксис
function Add(Name: Widestring; RefersTo: Widestring):
IXLSName;
function Add(Name: Widestring; RefersTo: Widestring; Visible: boolean):
IXLSName;
function Add(Name: Widestring; SheetName: Widestring; Row: Integer; Col: Integer):
IXLSName;
function Add(Name: Widestring; SheetName: Widestring; Row1: Integer; Col1: Integer; Row2: Integer; Col2: Integer):
IXLSName;
| Name |
Обязательный параметр типа Widestring. Текст, используемый в качестве имени. Имена не могут содержать пробелы и не должны быть похожи на ссылки на ячейки |
| RefersTo |
Обязательный параметр типа Widestring. Описывает, на что ссылается имя (в нотации стиля A1) |
| Visible |
Необязательный параметр типа Boolean. Значение True определяет имя обычным образом, False — как скрытое имя (то есть оно не отображается ни в диалоговом окне «Присвоение имени», ни в окнах «Вставка имени» и «Переход»). Значение по умолчанию — True |
| SheetName |
Обязательный параметр типа Widestring. Рабочий лист, которому принадлежит целевая ячейка или диапазон |
| Row |
Обязательный параметр типа Integer. Номер строки (нумерация ведётся с единицы) для целевой одиночной ячейки |
| Col |
Обязательный параметр типа Integer. Номер столбца (нумерация ведётся с единицы) для целевой одиночной ячейки |
| Row1, Col1, Row2, Col2 |
Обязательные параметры типа Integer. Координаты строк и столбцов (нумерация ведётся с единицы) для прямоугольного целевого диапазона |
Пример
В этом примере для книги добавляется новое определённое имя, которое затем используется в формуле ячейки
Workbook.Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[1].Cells[3,4].Formula := '=SUM(MyName)';
В этом примере имена для одиночной ячейки и диапазона создаются по координатам рабочего листа
Workbook.Names.Add('InputCell','Sheet1',2,3);
Workbook.Names.Add('InputBlock','Sheet1',4,2,6,5);
В этом примере для первого рабочего листа добавляется новое определённое имя, которое затем используется в формуле ячейки
Workbook.Sheets[1].Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[2].Cells[3,4].Formula := '=SUM(Sheet1!MyName)';
См. также