Základní API Aspose.Slides FOSS pro Java

Úvodní článek

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 balíček a cíle Java 21 nebo vyšší.

Projekt je vydán pod licencí MIT, takže jej můžete používat jak v osobních tak i komerčních projektech bez nákladů a bez API klíče. Poskytuje bohatý objektový model pro slaidy, tvary, text, tabulky, obrázky, komentáře a vlastnosti dokumentů podporovaný přímou manipulací formátu balíčku Office Open XML .

S 273 třídami, více než 2600 metodami a 42 vyčíslením pokrývá základní API stavební bloky potřebné k automatizaci prezentačních pracovních postupů v jakékoli aplikaci Java.

Co se v ní nachází?

Představení Životní cyklus

Úřad pro bezpečnost a ochranu zdraví Presentation třída je vstupní bod pro každou operaci. Můžete vytvořit prázdnou prezentaci a uložit výsledek na disku nebo do disku, kde se objeví databáze s funkcí “Disk”. OutputStream třída implementuje AutoCloseable,Takže to funguje přirozeně s bloky, které se snaží o zdroje.

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

Správa snímků

SlideCollection poskytuje plné ovládání deskového balíčku. Můžete přidat prázdné snímky se addEmptySlide(), duplikujte stávající snímky se addClone(), vložte snímky na konkrétní index se insertEmptySlide(), odstranit snímky podle odkazu nebo indexu a opakovat kolekci.

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

Tvary a automatické tvary

Úřad pro bezpečnost a ochranu zdraví AutoShape třída představuje nejběžnější kreslitelný objekt na slide. Vytváříte tvary prostřednictvím IShapeCollection.addAutoShape(), s upřesněním a ShapeType konstantní (např. ShapeType.RECTANGLE) a souřadnice polohy. AutoShape odhaluje a. TextFrame pro textový obsah a FillFormat pro vizuální 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 a odstavce

Rich text je modelován jako hierarchie: TextFrame, ParagraphCollection, Paragraph, PortionCollection,a) Portion Můžete nastavit prostý text na rámečku přímo s TextFrame.setText(), nebo vytvořit víceprovozní odstavce přidáním individuální Portion instanci s odlišným formátováním.

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

Vlastnosti dokumentu

Úřad pro bezpečnost a ochranu zdraví DocumentProperties Vytváření vlastností se zachovává v jádru PPTX a rozšířených částech vlastostí a přežívá cykly ukládání/nové načítání z cesty na cestu.

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

Poznámky a poznámky

Podsystém připomínek zahrnuje: CommentAuthorCollection a) CommentCollection.Můžete přidat autory, připojit komentáře k specifickým snímkům a pozicím a přečíst existující poznámky. Údaje o komentářích jsou uloženy v aplikaci ppt/commentAuthors.xml a) ppt/comments/*.xml části balení PPTX.

Rychlý start

Přidejte Mavenova závislost k vaší pom.xml:

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

Pak vytvořte a uložte prezentaci:

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

Podporované formáty

Úřad pro bezpečnost a ochranu zdraví SaveFormat Vypočítání definuje každý výstupní formát, který knihovna může psát. Níže uvedená tabulka uvádí potvrzené záznamy.

Poznámka: V současné době je implementován pouze export PPTX. SaveFormat V současné době se na ně používá pro budoucí kompatibilitu, ale ještě nejsou funkční. save() metoda vždy vyprodukuje výstup PPTX bez ohledu na parametr formátu.

Open Source & Licence

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.Můžete knihovnu používat, upravovat a redistribuovat v jakémkoli projektu bez poplatků za licenční klíče.

Jak začít?

Připraveni k hloubkování? Zde jsou zdroje, které vám pomohou začít:

• Příručka pro vývojáře – průvodce a tutoriály pro každou oblast charakteristiky
• Základní znalosti – články o tom, jak se učit a často kladené otázky
• Odkaz na API – úplná dokumentace třídy a metody