chart ChartLine

ChartLine — Linhas

Gráfico de linhas, com suporte a marcadores nos pontos e suavização de curvas.
Elemento ECMA-376: c:lineChart (2D) / c:line3DChart (3D) — §21.2.2.99.

Criado via oExcel:NewChart("line") ou instância direta:

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

Herda todos os métodos da classe base Chart.

---

Métodos específicos

---

SetAgrupamento

:SetAgrupamento(cAgrupamento)
Define como as séries são agrupadas.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cAgrupamento	caractere	Tipo de agrupamento (tabela abaixo)	X	Default "standard"

Valor	Descrição
"standard"	Linhas independentes (padrão)
"stacked"	Empilhado
"percentStacked"	100% empilhado

Retorno: objeto self

---

SetMarcador

:SetMarcador(lMarcador)
Ativa ou desativa marcadores nos pontos de dados para todas as séries do gráfico.
O comportamento pode ser sobrescrito individualmente via :SetMarcador() da Serie.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
lMarcador	lógico	.T. exibe marcadores circulares		Default .F.

Retorno: objeto self

---

SetSuavizar

:SetSuavizar(lSuavizar)
Suaviza as curvas de todas as séries do gráfico.
O comportamento pode ser sobrescrito individualmente via :SetSuavizar() da Serie.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
lSuavizar	lógico	.T. suaviza as linhas		Default .F.

Retorno: objeto self

---

Exemplos

Linhas com marcadores (global):

Local oGraf := oExcel:NewChart("line")
oGraf:SetTitulo("Evolução Mensal")
oGraf:SetMarcador(.T.)
oGraf:AddSerie("Sudeste", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Sul",     "Dados!$C$2:$C$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 19, 16, 27)

Apenas uma série com suavização:

Local oGraf := oExcel:NewChart("line")
oGraf:SetMarcador(.T.)
oGraf:AddSerie("Sudeste", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Sul",     "Dados!$C$2:$C$7", "Dados!$A$2:$A$7")
Local oSerie := oGraf:AddSerie("Nordeste", "Dados!$D$2:$D$7", "Dados!$A$2:$A$7")
oSerie:SetSuavizar(.T.) // Só a série Nordeste é suavizada
oGraf:Insert(1, 19, 16, 27)

Linhas 3D:

Local oGraf := oExcel:NewChart("line")
oGraf:Set3D()
oGraf:AddSerie("Sudeste", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

Linhas empilhadas 100%:

Local oGraf := oExcel:NewChart("line")
oGraf:SetAgrupamento("percentStacked")
oGraf:AddSerie("Sudeste",  "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Sul",      "Dados!$C$2:$C$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Nordeste", "Dados!$D$2:$D$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

Obs

Em gráficos 3D, marcadores e suavização são ignorados (não aplicáveis ao ECMA-376 em 3D).