Gerar visualizações de planilhas é uma necessidade frequente ao criar painéis de relatórios ou resumos por e‑mail. Conholdate.Total for Java fornece um SDK robusto que simplifica o processo de conversão de Excel para imagem em aplicações Java. Neste guia, você verá como carregar uma pasta de trabalho XLSX, configurar a saída PNG e gerar arquivos de imagem para planilhas inteiras, gráficos ou intervalos específicos. Ao final, você terá um exemplo de código pronto‑para‑executar que pode adaptar aos seus próprios projetos.

O que a conversão de arquivos Excel para imagem exige da sua aplicação

Os desenvolvedores frequentemente precisam transformar o conteúdo de planilhas em imagens estáticas para visualizações na web, relatórios em PDF ou miniaturas móveis. O requisito normalmente inclui preservar a formatação de célula, renderizar gráficos incorporados e, opcionalmente, limitar a conversão a um único intervalo. Executar essas tarefas manualmente, abrindo o Excel, tirando capturas de tela e salvando-as, não escala e pode gerar resultados inconsistentes.

As restrições técnicas para uma solução confiável são: suporte a arquivos XLSX, capacidade de incluir gráficos e fórmulas, resolução de imagem configurável e processamento em lote de várias planilhas. A conversão deve ser executada em um ambiente de servidor ou desktop sem exigir o Microsoft Office.

Escolhendo Conholdate.Total for Java para o Trabalho

Conholdate.Total for Java oferece uma API unificada que cobre todas as capacidades necessárias. Seus ExcelLoadOptions permitem carregar gráficos e fórmulas, enquanto ImageConvertOptions oferecem controle granular sobre formato, qualidade e dimensões. O SDK funciona em qualquer runtime Java, requer apenas a dependência Maven e lida com grandes pastas de trabalho de forma eficiente.

Para uso detalhado da API, consulte a documentação oficial. A referência completa para classes como Conversion, ExcelLoadOptions e ImageConvertOptions está disponível na referência da API. Você pode baixar a biblioteca mais recente na página de lançamentos.

Implementando Conversão de Excel para Imagem em Java

O processo de conversão pode ser dividido em algumas etapas claras. As seções a seguir orientam você por cada parte, com trechos curtos de código extraídos diretamente do exemplo completo.

Instalar Conholdate.Total para Java via Maven

Adicione o repositório Maven da Conholdate e a dependência do SDK ao seu pom.xml:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Carregar arquivo Excel com suporte a gráficos e fórmulas

Crie uma instância de ExcelLoadOptions, habilite o carregamento de gráficos e fórmulas e inicialize o objeto Conversion com um fluxo de arquivo:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

Configurar Opções de Saída de Imagem para PNG

Defina o formato de imagem desejado, a qualidade e as dimensões. A largura é fixa, enquanto a altura preserva a proporção de aspecto:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Converter Cada Planilha ou Intervalo em Imagens PNG

Itere sobre as páginas da pasta de trabalho (planilhas) e converta cada uma. Você também pode direcionar um intervalo específico ajustando o pageNumber ou usando opções de carregamento adicionais:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Verificar Saída e Tratar Exceções

Envolva a lógica de conversão em um bloco try‑catch e garanta que o diretório de saída exista antes de iniciar:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

As etapas acima demonstram como converter Excel em imagem usando o Conholdate.Total SDK, proporcionando flexibilidade para lidar com gráficos, intervalos e planilhas completas.

Exemplo de Código Completo: Converter Excel em Imagem com Suporte a Planilha Inteira

O código a seguir mostra a implementação completa, pronta‑para‑executar, descrita nas etapas acima.

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (input.xlsx, output_images) para corresponder às suas localizações reais, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter ajuda.

Conclusão

Converter Excel para imagem em Java torna‑se simples quando você utiliza o Conholdate.Total for Java. O SDK lida com a renderização de gráficos, avaliação de fórmulas e geração de PNG de alta qualidade com código mínimo. Seguindo o guia passo a passo, você pode integrar essa funcionalidade em ferramentas de relatório, geradores de e‑mail ou qualquer aplicação que precise de representações visuais de planilhas. Lembre‑se de que implantações em produção exigem uma licença comercial; você pode explorar as opções de preço na página Conholdate.Total pricing e obter uma licença temporária na página de licença temporária durante a avaliação.

Perguntas Frequentes

  • Como posso converter Excel em imagem em Java?
    Use a classe Conversion do Conholdate.Total for Java, configure ExcelLoadOptions e ImageConvertOptions, então chame convert para cada planilha.

  • Posso converter um gráfico do Excel em uma imagem?
    Sim. Ative o carregamento de gráficos com loadOptions.setLoadCharts(true) e especifique o número da página do gráfico ao definir imgOptions.setPageNumber.

  • É possível converter apenas um intervalo específico de células?
    Você pode definir um intervalo nas opções de carregamento ou selecionar o número da página apropriado que corresponde ao intervalo desejado antes da conversão.

  • Qual licenciamento é necessário para uso em produção?
    É necessária uma licença comercial. Revise os custos na página Conholdate.Total pricing e obtenha uma licença temporária na página de licença temporária.

Leia Mais