chart ChartBar

ChartBar — Barras e Colunas

Gráfico de barras horizontais ou colunas verticais.
Elemento ECMA-376: c:barChart (2D) / c:bar3DChart (3D) — §21.2.2.16.

Criado via oExcel:NewChart("col"), oExcel:NewChart("bar") ou instância direta:

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

Herda todos os métodos da classe base Chart.

---

Métodos específicos

---

SetDirecao

:SetDirecao(cDirecao)
Define se o gráfico exibe colunas verticais ou barras horizontais.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cDirecao	caractere	"col" = colunas verticais, "bar" = barras horizontais	X

Retorno: objeto self

---

SetAgrupamento

:SetAgrupamento(cAgrupamento)
Define como as séries são agrupadas no gráfico.

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

Valor	Descrição
"clustered"	Agrupado (barras lado a lado) — padrão
"stacked"	Empilhado (barras acumuladas)
"percentStacked"	100% empilhado

Retorno: objeto self

---

SetGapWidth

:SetGapWidth(nGapWidth)
Define o espaço entre os grupos de barras/colunas.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
nGapWidth	numérico	Percentual do espaço (0 a 500)	X	Default 150

Retorno: objeto self

---

Exemplos

Colunas agrupadas (padrão):

Local oGraf := oExcel:NewChart("col")
oGraf:SetTitulo("Vendas por Região - Colunas")
oGraf:AddSerie("Sudeste", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7", aSudeste, aMeses)
oGraf:AddSerie("Sul",     "Dados!$C$2:$C$7", "Dados!$A$2:$A$7", aSul, aMeses)
oGraf:AddSerie("Nordeste","Dados!$D$2:$D$7", "Dados!$A$2:$A$7", aNordeste, aMeses)
oGraf:Insert(1, 9, 16, 17)

Barras horizontais empilhadas com cores:

Local oGraf := oExcel:NewChart("bar")
oGraf:SetAgrupamento("stacked")
oGraf:SetTitulo("Vendas Empilhadas")
oGraf:SetLegenda(.T., "b")
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:AddSerie("Nordeste","Dados!$D$2:$D$7", "Dados!$A$2:$A$7", cCor = "FF9BBB59")
oGraf:Insert(18, 9, 33, 17)

100% empilhado com 3D:

Local oGraf := oExcel:NewChart("col")
oGraf:SetAgrupamento("percentStacked")
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)