Skip to content

chart Set3D

Saulo Martins edited this page Jul 4, 2026 · 1 revision

Set3D (Chart)

:Set3D(lAtivo, nRotX, nRotY, nPerspectiva)
Ativa a visualização 3D do gráfico, gerando c:view3D e alterando o elemento do gráfico para a variante 3D
(bar3DChart, line3DChart, pie3DChart, area3DChart, surface3DChart).

Suportado em: ChartBar, ChartLine, ChartPie, ChartArea e ChartSurface.

Não disponível em: ChartScatter, ChartBubble, ChartRadar, ChartDoughnut, ChartOfPie e ChartCombo.
Nesses tipos, chamar :Set3D() gera uma UserException.

Método da classe base Chart, sobrescrito nas classes sem suporte 3D.


Parâmetros

Parâmetro Tipo Descrição Obrigatório Obs
lAtivo lógico .T. ativa o 3D Default .T.
nRotX numérico Rotação X em graus (inclinação) Default 15
nRotY numérico Rotação Y em graus (giro horizontal) Default 20
nPerspectiva numérico Perspectiva em % Default 30

Retorno

Objeto — self (permite encadeamento)


Exemplos

Colunas 3D com configuração padrão:

Local oGraf := oExcel:NewChart("col")
oGraf:Set3D()
oGraf:SetTitulo("Vendas 3D")
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)

Rotação personalizada:

oGraf:Set3D(lAtivo = .T., nRotX = 30, nRotY = 45, nPerspectiva = 20)

Pizza 3D:

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

Superfície 3D:

Local oGraf := custom.excel.chart.ChartSurface():New(oExcel)
oGraf:Set3D() // ChartSurface é sempre 3D, Set3D é opcional para ajustar ângulos
oGraf:AddSerie("Z", "Dados!$B$2:$D$7", "Dados!$A$2:$A$7")
oGraf:Insert(1, 9, 16, 17)

Clone this wiki locally