chart Insert

Insert (Chart)

:Insert(nLinha, nColuna, nLinha2, nColuna2)
Insere o gráfico na planilha atual, ancorado entre duas células (xdr:twoCellAnchor).
Deve ser chamado após configurar todas as séries e opções, e antes do Save/Gravar do Excel.

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

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
nLinha	numérico	Linha inicial da âncora (base 1)		Default = 1
nColuna	numérico	Coluna inicial da âncora (base 1)		Default = 1
nLinha2	numérico	Linha final da âncora (base 1)		Default = nLinha + 15
nColuna2	numérico	Coluna final da âncora (base 1)		Default = nColuna + 8

Retorno

Sem retorno (Nil)

---

Exemplos

Posição mínima (usando defaults):

oGraf:Insert() // Ancora nas células A1:J16

Posição explícita:

// Gráfico de A1 até Q16 (linhas 1-16, colunas 1-17)
oGraf:Insert(nLinha = 1, nColuna = 1, nLinha2 = 16, nColuna2 = 17)

Dois gráficos lado a lado:

oGraf1:Insert(1, 9, 16, 17)   // Lado direito da tabela de dados
oGraf2:Insert(18, 9, 33, 17)  // Abaixo do primeiro gráfico

Múltiplos gráficos na mesma planilha:

// Gráfico de colunas
Local oGraf1 := oExcel:NewChart("col")
oGraf1:SetTitulo("Colunas")
oGraf1:AddSerie("Vendas", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf1:Insert(1, 9, 16, 17)

// Gráfico de linhas
Local oGraf2 := oExcel:NewChart("line")
oGraf2:SetTitulo("Tendência")
oGraf2:AddSerie("Vendas", "Dados!$B$2:$B$7", "Dados!$A$2:$A$7")
oGraf2:Insert(18, 9, 33, 17)

Obs

• Os índices de linha e coluna são base 1 (igual ao restante da API).
• A célula final (nLinha2, nColuna2) deve ser estritamente maior que a inicial.
• Cada chamada a :Insert() gera um arquivo /xl/charts/chartN.xml independente.
• O mesmo objeto de gráfico não pode ser inserido mais de uma vez.