HotXLS-documentatie

Add methode

Definieert een nieuwe naam. Retourneert een IXLSName-interface

Syntaxis

functie Add(Name: Widestring; RefersTo: Widestring): IXLSName;
functie Add(Name: Widestring; RefersTo: Widestring; Visible: boolean): IXLSName;
functie Add(Name: Widestring; SheetName: Widestring; Row: Integer; Col: Integer): IXLSName;
functie Add(Name: Widestring; SheetName: Widestring; Row1: Integer; Col1: Integer; Row2: Integer; Col2: Integer): IXLSName;
Name Verplichte Widestring. De tekst om als naam te gebruiken. Namen mogen geen spaties bevatten en mogen er niet uitzien als celverwijzingen
RefersTo Verplichte Widestring. Beschrijft waarnaar de naam verwijst (in A1-stijl)
Visible Optionele Boolean. True om de naam normaal te definiëren. False om de naam als verborgen naam te definiëren (die verschijnt niet in de Define Name-, Paste Name- of Goto-dialoog). De standaardwaarde is True
SheetName Verplichte Widestring. Het werkblad dat de doelcel of het doelbereik bezit
Row Verplicht Integer. De 1-based rij voor een doel van één cel
Col Verplicht Integer. De 1-based kolom voor een doel van één cel
Row1, Col1, Row2, Col2 Verplichte Integers. De 1-based rij- en kolomcoördinaten voor een rechthoekig doelbereik

Voorbeeld

Dit voorbeeld voegt een nieuwe gedefinieerde naam toe voor de werkmap en gebruikt deze naam in de celformule

Workbook.Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[1].Cells[3,4].Formula := '=SUM(MyName)';
Dit voorbeeld maakt namen voor één cel en bereiknamen op basis van werkbladcoördinaten

Workbook.Names.Add('InputCell','Sheet1',2,3);
Workbook.Names.Add('InputBlock','Sheet1',4,2,6,5);
Dit voorbeeld voegt een nieuwe gedefinieerde naam toe voor het werkblad zelf en gebruikt deze naam in de celformule

Workbook.Sheets[1].Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[2].Cells[3,4].Formula := '=SUM(Sheet1!MyName)';

Zie ook