chart AddSerie

AddSerie (Chart)

:AddSerie(cNome, cRefVal, cRefCat, aVal, aCat, cCor)
Adiciona uma série de dados ao gráfico.
Retorna o objeto Serie criado, permitindo encadeamento de métodos adicionais.

Método disponível em todos os tipos de gráfico (classe base Chart).

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cNome	caractere	Nome da série. Pode ser texto literal ou referência de célula (ex: "Dados!$B$1")
cRefVal	caractere	Referência dos valores no Excel (ex: "Dados!$B$2:$B$7")	X*	*Obrigatório se aVal não for informado
cRefCat	caractere	Referência das categorias/eixo X (ex: "Dados!$A$2:$A$7")
aVal	array	Valores literais — gera cache no XML, dispensando acesso à planilha no Excel
aCat	array	Categorias literais — gera cache no XML
cCor	caractere	Cor da série em formato RGB (6 dígitos) ou ARGB (8 dígitos), ex: "FF4F81BD"

Retorno

Objeto — instância da classe Serie (permite ajustes encadeados via métodos SetXY, SetTamanho, SetMarcador, SetSuavizar, SetExplosao, SetCor)

---

Métodos do objeto Serie retornado

Método	Descrição
:SetCor(cCor)	Define ou altera a cor da série
:SetMarcador(lMarcador)	Ativa/desativa marcador nos pontos (linhas/dispersão)
:SetSuavizar(lSuavizar)	Suaviza a linha desta série (linhas/dispersão)
:SetExplosao(nExplosao)	Afastamento da fatia em % (pizza)
:SetXY(cRefX, cRefY, aX, aY)	Define eixos X e Y para dispersão/bolhas
:SetTamanho(cRefTam, aTam)	Define o tamanho das bolhas (ChartBubble)

---

Exemplos

Série com referência de células (mais comum):

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")

Série com valores literais (sem referência de células):

Local aMeses    := {"Jan","Fev","Mar","Abr","Mai","Jun"}
Local aSudeste  := {100,120,90,140,160,150}
oGraf:AddSerie("Sudeste", , , aVal = aSudeste, aCat = aMeses)

Referência + cache (melhora abertura no Excel):

oGraf:AddSerie("Sudeste", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7", aSudeste, aMeses)

Série com cor personalizada e ajuste individual:

oGraf:AddSerie("Nordeste", "Dados!$D$2:$D$7", "Dados!$A$2:$A$7", cCor = "FF9BBB59")

Modificar série após criação (ex: suavizar apenas uma série):

Local oSerie := oGraf:AddSerie("Nordeste", "Dados!$D$2:$D$7", "Dados!$A$2:$A$7")
oSerie:SetSuavizar(.T.)
oSerie:SetCor("FF9BBB59")

Série de dispersão XY:

Local oSerie := oGraf:AddSerie("Medições")
oSerie:SetXY("Dados!$F$2:$F$11", "Dados!$G$2:$G$11", aTemp, aSorvete)

Série de pizza com explosão da fatia:

Local oSerie := oGraf:AddSerie("Total", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oSerie:SetExplosao(20) // 20% de afastamento