Documentação do HotXLS

método Add

Define um novo nome. Devolve a Interface IXLSName

Sintaxe

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 obrigatório. O texto a utilizar como nome. Os nomes não podem conter espaços nem assemelhar-se a referências de células
RefersTo Widestring obrigatório. Descreve aquilo a que o nome se refere (utilizando a notação de estilo A1)
Visible Booleano opcional. True para definir o nome normalmente. False para definir o nome como um nome oculto (ou seja, não aparece nas caixas de diálogo Definir Nome, Colar Nome ou Ir Para). O valor predefinido é True
SheetName Widestring obrigatório. A folha de cálculo à qual pertence a célula ou o intervalo de destino
Row Integer obrigatório. A linha, com base 1, de um destino de célula única
Col Integer obrigatório. A coluna, com base 1, de um destino de célula única
Row1, Col1, Row2, Col2 Integers obrigatórios. As coordenadas de linha e coluna, com base 1, de um intervalo de destino rectangular

Exemplo

Este exemplo adiciona um novo nome definido ao livro e utiliza esse nome na fórmula da célula

Workbook.Names.Add('MyName','=Sheet1!$F$10:$H$20');
Workbook.Sheets[1].Cells[3,4].Formula := '=SUM(MyName)';
Este exemplo cria nomes de célula única e de intervalo a partir de coordenadas da folha de cálculo

Workbook.Names.Add('InputCell','Sheet1',2,3);
Workbook.Names.Add('InputBlock','Sheet1',4,2,6,5);
Este exemplo adiciona um novo nome definido à folha de cálculo um e utiliza esse nome na fórmula da célula

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

Consulte também