Dokumentacja HotXLS

Add metoda

Definiuje nową nazwę. Zwraca interfejs IXLSName

Składnia

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 Wymagany parametr typu Widestring. Tekst używany jako nazwa. Nazwy nie mogą zawierać spacji ani przypominać odwołań do komórek
RefersTo Wymagany parametr typu Widestring. Opisuje, do czego odwołuje się nazwa (z użyciem notacji w stylu A1)
Visible Opcjonalny parametr typu Boolean. Wartość True powoduje zdefiniowanie nazwy w zwykły sposób. Wartość False definiuje nazwę jako ukrytą (to znaczy taką, która nie pojawia się ani w oknie dialogowym Definiowanie nazwy, ani Wklejanie nazwy, ani Przejdź do). Wartość domyślna to True
SheetName Wymagany parametr typu Widestring. Arkusz, do którego należy docelowa komórka lub zakres
Row Wymagany parametr typu Integer. Numer wiersza (numeracja od 1) dla celu obejmującego pojedynczą komórkę
Col Wymagany parametr typu Integer. Numer kolumny (numeracja od 1) dla celu obejmującego pojedynczą komórkę
Row1, Col1, Row2, Col2 Wymagane parametry typu Integer. Współrzędne wierszy i kolumn (numeracja od 1) dla prostokątnego docelowego zakresu

Przykład

Ten przykład dodaje nową zdefiniowaną nazwę dla skoroszytu i używa tej nazwy w formule komórki
Workbook.Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[1].Cells[3,4].Formula := '=SUM(MyName)';
Ten przykład tworzy nazwy pojedynczej komórki i zakresu na podstawie współrzędnych arkusza
Workbook.Names.Add('InputCell','Sheet1',2,3);
Workbook.Names.Add('InputBlock','Sheet1',4,2,6,5);
Ten przykład dodaje nową zdefiniowaną nazwę dla pierwszego arkusza i używa tej nazwy w formule komórki
Workbook.Sheets[1].Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[2].Cells[3,4].Formula := '=SUM(Sheet1!MyName)';

Zobacz także