chart ChartDoughnut

ChartDoughnut — Rosca

Gráfico de rosca: pizza com um furo central vazio.
Elemento ECMA-376: c:doughnutChart — §21.2.2.50.

Herda de ChartPie, portanto suporta todos os métodos de pizza (SetRotulos, SetAnguloIni, explosão de fatias).

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

Somente via instância direta:

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

---

Método específico

---

SetFuro

:SetFuro(nFuro)
Define o tamanho do furo central da rosca.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
nFuro	numérico	Percentual do furo (10 a 90)	X	Default 50

Retorno: objeto self

---

Exemplos

Rosca padrão:

Local oGraf := custom.excel.chart.ChartDoughnut():New(oExcel)
oGraf:SetTitulo("Participação — Rosca")
oGraf:SetRotulos(.T., lPercentual = .T., lCategoria = .T.)
oGraf:AddSerie("Regiões", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7", aSudeste, aMeses)
oGraf:Insert(1, 9, 16, 17)

Rosca com furo menor:

Local oGraf := custom.excel.chart.ChartDoughnut():New(oExcel)
oGraf:SetFuro(30)  // Furo de 30%
oGraf:SetRotulos(.T.)
oGraf:AddSerie("Vendas", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

---

ChartOfPie — Pizza de Pizza / Barra de Pizza

Gráfico que destaca as menores fatias em um gráfico secundário (pizza ou barra).
Elemento ECMA-376: c:ofPieChart — §21.2.2.126.

Herda de ChartPie.

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

Somente via instância direta:

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

---

Métodos específicos

---

SetTipo

:SetTipo(cTipo)
Define o tipo do gráfico secundário.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cTipo	caractere	"pie" = pizza de pizza, "bar" = barra de pizza	X	Default "pie"

Retorno: objeto self

---

SetDivisao

:SetDivisao(cTipo, nValor)
Define o critério de separação das fatias para o gráfico secundário.

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cTipo	caractere	Critério de divisão (tabela abaixo)	X	Default "auto"
nValor	numérico	Valor do critério (quando não automático)

Valor de cTipo	Descrição
"auto"	Automático (Excel decide)
"pos"	Últimas N fatias vão para o secundário
"val"	Fatias com valor menor que N vão para o secundário
"percent"	Fatias com percentual menor que N vão para o secundário

Retorno: objeto self

---

Exemplo

Local oGraf := custom.excel.chart.ChartOfPie():New(oExcel)
oGraf:SetTipo("bar")               // Gráfico secundário como barra
oGraf:SetDivisao("pos", 3)         // Últimas 3 fatias vão para a barra
oGraf:SetRotulos(.T., lPercentual = .T.)
oGraf:AddSerie("Vendas", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)