Het genereren van visuele previews van spreadsheet‑gegevens is een veelvoorkomende eis bij het bouwen van rapportagedashboards of e‑mailoverzichten. Conholdate.Total for Java biedt een robuuste SDK die het proces van het converteren van Excel naar afbeelding in Java‑toepassingen vereenvoudigt. In deze gids zie je hoe je een XLSX‑werkmap laadt, PNG‑output configureert en afbeeldingsbestanden maakt voor volledige werkbladen, grafieken of specifieke bereiken. Aan het einde heb je een kant‑klaar code‑voorbeeld dat je kunt aanpassen aan je eigen projecten.

Wat Convert Excel Files to Image van uw applicatie vereist

Ontwikkelaars moeten vaak spreadsheetinhoud omzetten naar statische afbeeldingen voor webvoorbeelden, PDF rapporten of mobiele miniaturen. De vereiste omvat meestal het behouden van de opmaak van cellen, het renderen van ingesloten grafieken, en optioneel het beperken van de conversie tot één bereik. Het handmatig uitvoeren van deze taken door Excel te openen, screenshots te maken en ze op te slaan, schaalt niet en kan leiden tot inconsistente resultaten.

Technische beperkingen voor een betrouwbare oplossing zijn: ondersteuning voor XLSX‑bestanden, mogelijkheid om grafieken en formules op te nemen, configureerbare beeldresolutie en batchverwerking van meerdere werkbladen. De conversie moet draaien op een server‑ of desktopomgeving zonder dat Microsoft Office vereist is.

Kiezen van Conholdate.Total for Java voor de taak

Conholdate.Total for Java biedt een uniforme API die alle benodigde mogelijkheden dekt. Met zijn ExcelLoadOptions kun je diagrammen en formules laden, terwijl ImageConvertOptions fijne controle bieden over formaat, kwaliteit en afmetingen. De SDK werkt op elke Java-runtime, vereist alleen de Maven‑dependency en verwerkt grote werkboeken efficiënt.

Voor gedetailleerd API‑gebruik zie de officiële documentatie. De volledige referentie voor klassen zoals Conversion, ExcelLoadOptions en ImageConvertOptions is beschikbaar in de API‑referentie. Je kunt de nieuwste bibliotheek downloaden van de release‑pagina.

Implementatie van Excel-naar-afbeeldingsconversie in Java

Het conversieproces kan worden opgedeeld in een paar duidelijke stappen.
De volgende secties leiden u door elk onderdeel, met korte codefragmenten die rechtstreeks uit het volledige voorbeeld zijn genomen.

Installeer Conholdate.Total voor Java via Maven

Voeg de Conholdate Maven-repository en de SDK-afhankelijkheid toe aan uw 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>

Excel-bestand laden met ondersteuning voor grafieken en formules

Maak een ExcelLoadOptions-instantie, schakel het laden van grafieken en formules in en initialiseert het Conversion-object met een bestandsstroom:

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

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

Configureer afbeeldingsuitvoeropties voor PNG

Stel het gewenste afbeeldingsformaat, de kwaliteit en de afmetingen in. De breedte is vast, terwijl de hoogte de beeldverhouding behoudt:

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

Converteer elk werkblad of bereik naar PNG-afbeeldingen

Itereer over de werkboekpagina’s (bladen) en converteer elk van hen. Je kunt ook een specifiek bereik targeten door de pageNumber aan te passen of extra laadopties te gebruiken:

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);
}

Controleer de uitvoer en verwerk uitzonderingen

Plaats de conversielogica in een try‑catch‑blok en zorg ervoor dat de uitvoermap bestaat voordat u begint:

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();
}

De bovenstaande stappen laten zien hoe u Excel naar afbeelding kunt converteren met de Conholdate.Total SDK, terwijl u flexibiliteit krijgt om grafieken, bereiken en volledige werkbladen te verwerken.

Volledig codevoorbeeld: Excel naar afbeelding converteren met volledige bladondersteuning

De volgende code toont de volledige, kant‑klaar implementatie die in de bovenstaande stappen wordt beschreven.

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();
        }
    }
}

Opmerking: Deze codevoorbeeld toont de kernfunctionaliteit. Voordat u het in uw project gebruikt, moet u de bestandspaden (input.xlsx, output_images) aanpassen aan uw werkelijke bestandslocaties, controleren of alle vereiste afhankelijkheden correct zijn geïnstalleerd, en grondig testen in uw ontwikkelomgeving. Als u problemen ondervindt, raadpleeg dan de officiële documentatie of neem contact op met het ondersteuningsteam voor hulp.

Conclusie

Het converteren van Excel naar afbeelding in Java wordt eenvoudig wanneer je gebruikmaakt van Conholdate.Total for Java. De SDK verwerkt het renderen van grafieken, de evaluatie van formules en levert PNG‑output van hoge kwaliteit met minimale code. Door de stap‑voor‑stap‑gids te volgen, kun je deze functionaliteit integreren in rapportagetools, e‑mailgeneratoren of elke applicatie die visuele spreadsheet‑representaties nodig heeft. Houd er rekening mee dat productie‑implementaties een commerciële licentie vereisen; je kunt de prijsopties bekijken op de Conholdate.Total pricing pagina en een tijdelijke licentie verkrijgen via de tijdelijke licentiepagina tijdens de evaluatie.

Veelgestelde vragen

  • Hoe kan ik Excel naar afbeelding converteren in Java?
    Gebruik de Conversion-klasse van Conholdate.Total for Java, configureer ExcelLoadOptions en ImageConvertOptions, en roep vervolgens convert aan voor elk werkblad.

  • Kan ik een Excel‑diagram naar een afbeelding converteren?
    Ja. Schakel het laden van diagrammen in met loadOptions.setLoadCharts(true) en geef het paginanummer van het diagram op bij het instellen van imgOptions.setPageNumber.

  • Is het mogelijk om alleen een specifiek bereik van cellen te converteren?
    U kunt een bereik definiëren in de laadopties of het juiste paginanummer selecteren dat overeenkomt met het gewenste bereik vóór de conversie.

  • Welke licentie is vereist voor productiegebruik?
    Een commerciële licentie is vereist. Bekijk de kosten op de Conholdate.Total prijzen pagina en verkrijg een tijdelijke licentie via de tijdelijke licentiepagina.

Lees meer