Az Aspose.Slides FOSS Java Core API

Bevezetés

Aspose.Slides FOSS for Java egy ingyenes, nyílt forráskódú könyvtár, amely lehetővé teszi a Java fejlesztők számára, hogy PowerPoint előadásokat hozzanak létre és manipuláljanak anélkül, hogy a Microsoft Office-tól függnének. A könyvtár a org.aspose.slides.foss csomagban érkezik, és a Java 21 és újabb verzióira céloz.

A projekt az MIT licenc alatt került kiadásra, így személyes és kereskedelmi projektekben is ingyenesen, API kulcs nélkül használható. Gazdag objektummodellt biztosít diákhoz, alakzatokhoz, szöveghez, táblázatokhoz, képekhez, megjegyzésekhez és dokumentumtulajdonságokhoz, amelyet az Office Open XML csomagformátum közvetlen manipulációja támogat.

273 osztállyal, több mint 2,600 metódussal és 42 enumerációval a core API lefedi az építőelemeket, amelyekre szüksége van a prezentációs munkafolyamatok automatizálásához bármely Java-alkalmazásban.

Mi van benne

Prezentáció életciklusa

A Presentation osztály minden művelet belépési pontja. Létrehozhat egy üres prezentációt, és elmentheti az eredményt lemezre vagy egy OutputStream‑ba különféle formátumokban. Az osztály implementálja a AutoCloseable‑t, így természetesen működik a try‑with‑resources blokkokkal.

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

Dia kezelés

SlideCollection teljes irányítást biztosít a diakészlet felett. Üres diák hozzáadásához használhatja a addEmptySlide()‑t, meglévő diák duplikálásához a addClone()‑t, diák beszúrásához egy adott indexnél a insertEmptySlide()‑t, diákok eltávolításához hivatkozás vagy index alapján, valamint iterálhat a gyűjteményen.

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

Alakzatok és AutoShapes

A AutoShape osztály a leggyakoribb rajzolható objektumot képviseli egy dián. Alakzatokat a IShapeCollection.addAutoShape() segítségével hozol létre, megadva egy ShapeType állandót (például ShapeType.RECTANGLE) és a pozíció koordinátákat. Minden AutoShape egy TextFrame-t biztosít a szövegtartalomhoz és egy FillFormat-t a vizuális stílushoz.

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

Szöveg és bekezdések

A Rich text-et TextFrame, ParagraphCollection, Paragraph, PortionCollection és Portion objektumok hierarchiájaként modellezik. A sima szöveget közvetlenül egy kerethez állíthatja be TextFrame.setText() segítségével, vagy több futású bekezdéseket építhet fel egyedi Portion példányok hozzáadásával, amelyek különböző formázással rendelkeznek.

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

Dokumentum tulajdonságai

A DocumentProperties osztály standard metaadatmezőket tesz elérhetővé, mint például a cím, szerző, tárgy, kulcsszavak, kategória és időbélyegek. A tulajdonságok a PPTX alap‑ és kiterjesztett tulajdonságok részeiben tárolódnak, és túlélnek a mentés/újratöltés körkörös ciklusait.

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

Megjegyzések és annotációk

A megjegyzés alrendszer tartalmazza a CommentAuthorCollection és CommentCollection elemeket. Hozzáadhatsz szerzőket, csatolhatsz megjegyzéseket konkrét diákhoz és pozíciókhoz, valamint visszaolvashatod a meglévő annotációkat. A megjegyzés adatokat a PPTX csomag ppt/commentAuthors.xml és ppt/comments/*.xml részei tárolják.

Gyors kezdés

Adja hozzá a Maven függőséget a pom.xml-hez:

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

Ezután hozzon létre és mentse el a prezentációt:

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

Támogatott formátumok

A SaveFormat felsorolás meghatározza a könyvtár által írható összes kimeneti formátumot. Az alábbi táblázat felsorolja a megerősített bejegyzéseket.

A fent felsorolt formátumok megerősített exportcélok, amelyeket a SaveFormat enum definiál.

Nyílt forráskód és licencelés

Aspose.Slides FOSS for Java az MIT licenc alatt kerül terjesztésre. A teljes forráskód elérhető a GitHubon a Aspose.Slides-FOSS-for-Java címen. Szabadon használhatja, módosíthatja és újra terjesztheti a könyvtárat bármely projektben, jogdíj vagy licenckulcs nélkül.

Első lépések

Készen állsz mélyebbre merülni? Itt vannak az erőforrások, amelyek segítenek elkezdeni:

• Developer Guide – lépésről‑lépésre útmutatók és oktatóanyagok minden funkcióterülethez
• Knowledge Base – használati útmutató cikkek és gyakran ismételt kérdések
• API Reference – teljes osztály‑ és metódusdokumentáció