chart ChartArea

ChartArea — Área

Gráfico de área (preenchimento abaixo da linha), com variantes empilhada e 100% empilhada.
Elemento ECMA-376: c:areaChart (2D) / c:area3DChart (3D) — §21.2.2.5.

Somente via instância direta:

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

Herda todos os métodos da classe base Chart.

---

Métodos específicos

---

SetAgrupamento

:SetAgrupamento(cAgrupamento)
Define o tipo de agrupamento das séries.

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

Valor	Descrição
"standard"	Áreas sobrepostas (padrão)
"stacked"	Áreas empilhadas
"percentStacked"	100% empilhado

Retorno: objeto self

---

Exemplos

Área padrão:

Local oGraf := custom.excel.chart.ChartArea():New(oExcel)
oGraf:SetTitulo("Vendas — Área")
oGraf:AddSerie("Sudeste",  "Dados!$B$2:$B$7", "Dados!$A$2:$A$7", cCor = "FF4F81BD")
oGraf:AddSerie("Sul",      "Dados!$C$2:$C$7", "Dados!$A$2:$A$7", cCor = "FFC0504D")
oGraf:Insert(1, 9, 16, 17)

Área empilhada:

Local oGraf := custom.excel.chart.ChartArea():New(oExcel)
oGraf:SetAgrupamento("stacked")
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)

Área 3D:

Local oGraf := custom.excel.chart.ChartArea():New(oExcel)
oGraf:Set3D()
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, 9, 16, 17)

---

ChartStock — Ações

Gráfico de ações no formato High-Low-Close (máxima, mínima e fechamento).
Elemento ECMA-376: c:stockChart — §21.2.2.174.

Não possui versão 3D. Chamar :Set3D() gera UserException.

Somente via instância direta:

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

Herda todos os métodos da classe base Chart.
Não possui métodos específicos além dos herdados.

A ordem das séries é fixa: 1ª = Máxima, 2ª = Mínima, 3ª = Fechamento.

---

Exemplo

Local oGraf := custom.excel.chart.ChartStock():New(oExcel)
oGraf:SetTitulo("Ações - Jan/2024")
// As séries devem estar na ordem: Máxima, Mínima, Fechamento
oGraf:AddSerie("Máxima",    "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Mínima",    "Dados!$C$2:$C$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Fechamento","Dados!$D$2:$D$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

---

ChartRadar — Radar

Gráfico de radar (aranha/teia), útil para comparar múltiplas variáveis entre categorias.
Elemento ECMA-376: c:radarChart — §21.2.2.152.

Não possui versão 3D. Chamar :Set3D() gera UserException.

Somente via instância direta:

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

Herda todos os métodos da classe base Chart.

---

Método específico

SetEstilo

:SetEstilo(cEstilo)
Define o estilo visual do radar.

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

Valor	Descrição
"standard"	Radar com linhas (padrão)
"marker"	Radar com pontos marcados
"filled"	Radar preenchido (cada série como polígono sólido)

Retorno: objeto self

---

Exemplos

Local oGraf := custom.excel.chart.ChartRadar():New(oExcel)
oGraf:SetEstilo("filled")
oGraf:SetTitulo("Habilidades por Área")
oGraf:AddSerie("Equipe A", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:AddSerie("Equipe B", "Dados!$C$2:$C$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)