Skip to content

method ADDImg

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

ADDImg

:ADDImg(cImg)
Cadastra uma imagem no arquivo para ser usada nas planilhas pelo método Img


Parâmetros

Parâmetro Tipo Descrição Obrigatório Obs
cImg caractere Localização da imagem (caminho no servidor Protheus_data ou local) X Gera erro se o arquivo não existe

Retorno

Numérico - ID da imagem cadastrada


Img

:Img(nID,nLinha,nColuna,nX,nY,cUnidade,nRot)
Insere uma imagem cadastrada na planilha atual.

Parâmetros

Parâmetro Tipo Descrição Obrigatório Obs
nID numérico ID da imagem retornado pelo ADDImg X
nLinha numérico Linha para adicionar a imagem Default = linha posicionada
nColuna numérico Coluna para adicionar a imagem Default = coluna posicionada
nX numérico Largura da imagem X
nY numérico Altura da imagem X
cUnidade caractere Unidade da dimensão Default "px" (pixel)
nRot numérico Rotação da imagem em graus Default 0

Exemplo

Local nIDImg
Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan()
If File("\Star_Wars_Logo.png")
	nIDImg := oExcel:ADDImg("\Star_Wars_Logo.png") //Imagem no Protheus_data
	oExcel:Img(nID=nIDImg,nLinha=7,nColuna=7,nX=200,nY=121)
	oExcel:Img(nID=nIDImg,nLinha=2,nColuna=1,nX=121,nY=200,nRot=270) //Mesma imagem com rotação de 270 graus
EndIf
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

A mesma imagem cadastrada com ADDImg pode ser usada várias vezes, em planilhas diferentes, sem aumentar o tamanho do arquivo.


Clone this wiki locally