Kern-API von Aspose.Slides FOSS für Java

Einführung

Aspose.Slides FOSS for Java is a free, open-source library that lets Java developers create and manipulate PowerPoint presentations without any dependency on Microsoft Office. The library ships under the org.aspose.slides.foss Paket und Ziele Java 21 oder höher.

Das Projekt wird unter der MIT-Lizenz veröffentlicht, so dass Sie es sowohl in persönlichen als auch kommerziellen Projekten kostenlos und ohne API-Schlüssel verwenden können. Es bietet ein reichhaltiges Objektmodell für Dias, Formen, Text, Tabellen, Bilder, Kommentare und Dokumenteneigenschaften, unterstützt durch direkte Manipulation des Office Open XML-Paketformats .

Mit 273 Klassen, über 2.600 Methoden und 42 Aufzählungen deckt die Kern-API alle Bausteine ab, die Sie benötigen, um Präsentationsworkflows in jeder Java-Anwendung zu automatisieren.

Was ist darin enthalten?

Präsentation Lebenszyklus

Die Presentation Sie können eine leere Präsentation erstellen und das Ergebnis auf Disk oder in einem OutputStream Die Klasse implementiert die AutoCloseable, so dass es natürlich mit den Proben-mit-Ressourcen Blöcken funktioniert.

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation pres = new Presentation()) {
    // A new presentation starts with one blank slide
    System.out.println("Slides: " + pres.getSlides().size());
    pres.save("output.pptx", SaveFormat.PPTX);
}

Verarbeitung von Diapositen

SlideCollection Sie können leere Folie mit dem Schnittstellen-System hinzufügen. addEmptySlide(), die vorhandenen Diapositive mit dem addClone(), die Dias in einem bestimmten Index mit insertEmptySlide(), entfernen Sie die Folie nach Referenz oder Index und übersetzen Sie sie in der Sammlung.

try (Presentation pres = new Presentation()) {
    ILayoutSlide layout = pres.getLayoutSlides().get(0);
    pres.getSlides().addEmptySlide(layout);
    pres.getSlides().addClone(pres.getSlides().get(0));
    System.out.println("Total slides: " + pres.getSlides().size());
}

Formen und AutoFormen

Die AutoShape Sie erstellen Formen durch die Verwendung von Schaltflächen. IShapeCollection.addAutoShape(), mit Angabe einer ShapeType Konstante (wie z. B. ShapeType.RECTANGLE) und Positionskoordinaten. AutoShape eine TextFrame für den Textinhalt und eine FillFormat für die visuelle Styling.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100, false);
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS");
    System.out.println(tf.getText());
}

Text und Absätze

Rich Text ist als Hierarchie von TextFrame, ParagraphCollection, Paragraph, PortionCollection,und . Portion Sie können einfachen Text auf einen Rahmen direkt mit TextFrame.setText(), oder mehrfache Absätze erstellen, indem Sie einzelne Portion Instanzen mit unterschiedlicher Formatierung.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes()
        .addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 100, false);
    ITextFrame tf = shape.addTextFrame("First run ");
    Portion extra = new Portion("second run");
    tf.getParagraphs().get(0).getPortions().add(extra);
    System.out.println(tf.getText());
}

Dokument-Eigenschaften

Die DocumentProperties Die Eigenschaften bleiben im PPTX-Kern und in den erweiterten Eigentumsteilen erhalten und überleben Rundfahrtspeicher/Wiederladungssyklen.

try (Presentation pres = new Presentation()) {
    IDocumentProperties props = pres.getDocumentProperties();
    props.setTitle("Quarterly Report");
    props.setAuthor("Engineering Team");
    pres.save("report.pptx", SaveFormat.PPTX);
}

Anmerkungen und Beschreibungen

Das Kommentar-Teilsystem umfasst: CommentAuthorCollection und . CommentCollection.Sie können Autoren hinzufügen, Kommentare zu bestimmten Folien und Positionen beifügen und vorhandene Anmerkungen zurücklesen. ppt/commentAuthors.xml und . ppt/comments/*.xml Teile des PPTX-Paketts.

Schneller Start

Hinzu kommt die Maven-Abhängigkeit zu Ihrem pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>26.7.0</version>
</dependency>

Dann erstellen und speichern Sie eine Präsentation:

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

public class QuickStart {
    public static void main(String[] args) {
        try (Presentation pres = new Presentation()) {
            ISlide slide = pres.getSlides().get(0);

            // Add a title shape
            IAutoShape title = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 30, 600, 60, false);
            title.addTextFrame("Aspose.Slides FOSS for Java");

            // Add a content shape
            IAutoShape body = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 120, 600, 300, false);
            body.addTextFrame(
                "This presentation was created entirely in Java "
                + "using a free, open-source library.");

            pres.save("quick-start.pptx", SaveFormat.PPTX);
        }
    }
}

Unterstützte Formate

Die SaveFormat Die Liste der bestätigten Einträge ist in der Tabelle unten aufgeführt.

Anmerkung: Derzeit wird nur der PPTX-Export implementiert. SaveFormat Die neuen Systeme sind zwar nicht für die Zukunft kompatibel, aber noch nicht funktionsfähig. save() Die Methode erzeugt immer PPTX-Ausgabe, unabhängig vom Formatparameter.

Open Source und Lizenzierung

Aspose.Slides FOSS for Java is distributed under the MIT license. The full source code is available on GitHub at Aspose.Slides-FOSS-for-Java.Sie können die Bibliothek in jedem Projekt frei verwenden, ändern und weitergeben ohne Lizenzschlüssel oder Lizenzzuschläge.

Wie man anfängt

Hier sind einige Hilfsmittel, die Ihnen beim Einstieg helfen:

• Entwickler-Leitfaden – Durchführungen und Tutorials für jeden Feature-Bereich
• Wissensbasis – wie-zu-Artikel und häufig gestellte Fragen
• Referenz für die API – vollständige Klassen- und Methodendokumentation