Skip to content

method AddNome

Saulo Martins edited this page Jul 4, 2026 · 1 revision

AddNome

:AddNome(cNome,nLinha,nColuna,nLinha2,nColuna2,cRefPar,cPlanilha,cEscopo)
Cria um nome para referência de célula ou intervalo (Gerenciador de Nomes do Excel). O nome pode ser usado em fórmulas.


Parâmetros

Parâmetro Tipo Descrição Obrigatório Obs
cNome caractere Nome da referência X
nLinha numérico Linha da referência X
nColuna numérico Coluna da referência X
nLinha2 numérico Linha final, se intervalo
nColuna2 numérico Coluna final, se intervalo
cRefPar caractere Referência pronta (ex: "A1:C3") em vez de linha/coluna
cPlanilha caractere Nome da planilha da referência Default = planilha atual
cEscopo caractere Planilha de escopo do nome Default = pasta de trabalho

Retorno

Nulo

Exemplo

Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan()
oExcel:Pos(5,1):SetValue(100)
oExcel:Pos(5,2):SetValue(200)
oExcel:Pos(5,3):SetValue(300)
oExcel:AddNome(cNome="VALOR1",nLinha=5,nColuna=1)     //Nome para uma célula
oExcel:AddNome(cNome="VALORES",nLinha=5,nColuna=1,nLinha2=5,nColuna2=3)//Nome para um intervalo
oExcel:Pos(6,1):SetValue(xValor=102,cFormula="VALOR1+2")       //Fórmula usando o nome
oExcel:Pos(6,3):SetValue(xValor=600,cFormula="SUM(VALORES)")   //Fórmula com função e intervalo nomeado
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Clone this wiki locally