-
Notifications
You must be signed in to change notification settings - Fork 27
method ADDImg
Saulo Martins edited this page Jul 4, 2026
·
1 revision
:ADDImg(cImg)
Cadastra uma imagem no arquivo para ser usada nas planilhas pelo método Img
| 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 |
Numérico - ID da imagem cadastrada
:Img(nID,nLinha,nColuna,nX,nY,cUnidade,nRot)
Insere uma imagem cadastrada na planilha atual.
| 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 |
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()A mesma imagem cadastrada com ADDImg pode ser usada várias vezes, em planilhas diferentes, sem aumentar o tamanho do arquivo.
- Olá Mundo
- Exemplo Ler xlsx
- Métodos Principais
- New - Construtor da classe
- Open - Abrir planilha (senha opcional)
- GetError - Obter erro da última abertura
- AddPlan - Adicionar planilha
- SetValue - Definir valor da célula
- GetValue - Obter valor da célula
- Save - Salvar planilha
- SetPassword - Proteger com senha de abertura
- OpenApp / Close - Abrir no Excel / Fechar objeto
- SetsheetProtection - Proteger planilha contra edição
- Métodos Posicionamento e referência
- Métodos Células e Conteúdo
- Métodos Estilos
- NewStyle
- NewStyRules
- CorPreenc
- EfeitoPreenc
- AddFont
- Alinhamento
- Borda
- AddFmt
- AddFmtNum
- FormatCond / FormatCondDup / FormatCondTempo
- DataBar - Barra de dados
- IconSet - Conjunto de ícones
- Cellprotection
- Métodos Dimensões e Agrupamento
- Métodos Impressão
- Métodos Imagens
- Gráficos (Charts)
- Visão Geral — Tipos suportados
- Exemplo Completo
- NewChart - Criar gráfico pelo atalho
- Métodos comuns (todos os tipos)
- AddSerie - Adicionar série de dados
- SetTitulo / SetLegenda / SetGrade - Título, legenda e grade
- Set3D - Visualização 3D
- Insert - Inserir na planilha
- Tipos de gráfico
- ChartBar - Colunas e barras
- ChartLine - Linhas
- ChartPie - Pizza
- ChartScatter - Dispersão XY
- ChartArea / ChartStock / ChartRadar - Área, Ações e Radar
- ChartDoughnut / ChartOfPie - Rosca e Pizza de Pizza
- ChartBubble / ChartSurface - Bolhas e Superfície
- ChartCombo - Combinação de gráficos
- Tabela formatada
- Preenchimento em massa (bulk)
- Exemplo 1 - Básico
- BulkNewField - Definição de novas colunas do bulk
- DefBulkLine - Criar definição de campos para preenchimento em massa
- SetValueBulk - Definir valor para preenchimento de bulk
- SetBulkLine - Preenche a linha em bulk do Excel
- FlushBulk - Atualiza dados do Excel
- Preenchimento Excel com Query/Alias
- Exemplo 1 - Básico
- Alias2Tab - Preenche o Excel baseado no alias
- NewFldTab - Altera definição de campos ou cria novo campo
- DefSubTotal - Cria subtotal e agrupamento de subtotal
- NewRuleLine - Regra de formação de linhas