method NewChart

NewChart

:NewChart(cTipo)
Cria um objeto de gráfico vinculado ao Excel atual.
Atalho conveniente para os quatro tipos mais comuns de gráfico.
Para outros tipos, instancie a classe diretamente (veja Gráficos).

Fonte: src/custom.excel.tlpp — Método da classe Xlsx.

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cTipo	caractere	Tipo do gráfico (tabela abaixo)		Default "col"

Tipos disponíveis via NewChart

cTipo	Classe criada	Descrição
"col"	ChartBar com SetDirecao("col")	Colunas verticais agrupadas
"bar"	ChartBar com SetDirecao("bar")	Barras horizontais agrupadas
"line"	ChartLine	Linhas
"pie"	ChartPie	Pizza
"scatter"	ChartScatter	Dispersão XY

Retorno

Objeto — instância do gráfico (custom.excel.chart.Chart)

---

Exemplos

Gráfico de colunas agrupadas:

Local oExcel := custom.excel.Xlsx():New(cNomeFile = "Relatorio", cTipo = "A")
oExcel:ADDPlan(cNome = "Dados")
oExcel:Pos(1,1):SetValue("Jan") ; oExcel:Pos(1,2):SetValue(100)
oExcel:Pos(2,1):SetValue("Fev") ; oExcel:Pos(2,2):SetValue(120)
oExcel:Pos(3,1):SetValue("Mar") ; oExcel:Pos(3,2):SetValue(90)

Local oGraf := oExcel:NewChart("col")
oGraf:SetTitulo("Vendas Mensais")
oGraf:AddSerie("Vendas", "Dados!$B$1:$B$3", "Dados!$A$1:$A$3")
oGraf:Insert(nLinha = 1, nColuna = 4, nLinha2 = 16, nColuna2 = 12)

oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Destroy()

Gráfico de pizza com rótulos:

Local oGraf := oExcel:NewChart("pie")
oGraf:SetTitulo("Participação por Região")
oGraf:SetRotulos(lExibir = .T., lPercentual = .T.)
oGraf:AddSerie("Regiões", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

Obs

Para tipos avançados (Área, Radar, Rosca, Bolhas, Superfície, Combinação), instancie a classe diretamente:

Local oGraf := custom.excel.chart.ChartDoughnut():New(oExcel)