Introducció

Aspose.Slides FOSS for Java ja està disponible a Maven Central: una biblioteca gratuïta, amb llicència MIT, per crear, llegir i editar fitxers PowerPoint .pptx completament en Java, sense cap dependència de Microsoft Office ni cap entorn d’execució propietari.

La llibreria està dissenyada per a desenvolupadors que necessiten generar o manipular fitxers de presentació de manera programàtica: automatitzar presentacions a partir de dades, extreure text i metadades de fitxers PPTX pujats, construir pipelines de reporting basats en presentacions, o incrustar la creació de presentacions en aplicacions Spring Boot. Com que aspose-slides-foss és pur Java, es desplega de manera idèntica a Windows, macOS, Linux i contenidors Docker.

Característiques clau

  • Suport complet de viatge d’anada i tornada PPTX: Obriu qualsevol fitxer .pptx, modifiqueu-ne el contingut i deseu-lo de nou sense perdre les parts XML desconegudes que la biblioteca encara no entén.
  • Gestió de diapositives: Afegiu, elimineu i recorreu diapositives mitjançant prs.getSlides(); la presentació comença amb una diapositiva en blanc després de new Presentation().
  • AutoShapes, taules i connectors: Insereix formes mitjançant slide.getShapes().addAutoShape(), dades tabulars mitjançant slide.getShapes().addTable() i connectors visuals entre formes mitjançant slide.getShapes().addConnector().
  • Format de text enriquit: Formateu el text a nivell de caràcter amb PortionFormat: mida de la lletra, negreta, cursiva, subratllat i color ARGB mitjançant FillType.SOLID i ColorFormat.
  • Tipus d’emplenament: Apliqueu emplenaments FillType.SOLID, GRADIENT, PATTERN o PICTURE a qualsevol forma.
  • Efectes visuals: Ombra externa, resplendor, vora suau, difuminat, reflex i ombra interna mitjançant shape.getEffectFormat().
  • Format 3D: Bisell, càmera, equip de llum, material i profunditat d’extrusió mitjançant shape.getThreeDFormat().
  • Notes del presentador: Adjunteu text de notes a cada diapositiva mitjançant getNotesSlideManager().addNotesSlide().
  • Comentaris en fil: Afegiu comentaris amb metadades d’autor i posició de la diapositiva.
  • Imatges incrustades: Incrusteu des d’una ruta de fitxer, bytes o InputStream.
  • Propietats del document: Llegiu i escriviu propietats bàsiques, d’aplicació i personalitzades.

Començar

Afegeix la dependència Maven. Es requereix Java 21 o posterior.

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

Creeu la vostra primera presentació amb una forma i deseu-la:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

public class HelloSlides {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            ISlide slide = prs.getSlides().get(0);
            IAutoShape shape = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 50, 400, 120
            );
            shape.addTextFrame("Hello from Aspose.Slides FOSS!");
            prs.save("hello.pptx");
        }
    }
}

Utilitzeu sempre Presentation dins d’un bloc try‑with‑resources; això assegura que tots els recursos interns es alliberen quan el bloc surt.

Exemple de formatatge de text

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Bold heading in corporate blue");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(28);
    fmt.setFontBold(NullableBool.TRUE);
    fmt.getFillFormat().setFillType(FillType.SOLID);
    fmt.getFillFormat().getSolidFillColor().setColor(new Color(0, 70, 127));
    prs.save("formatted.pptx");
}

Limitacions actuals

Les àrees següents generen UnsupportedOperationException en aquesta versió:

  • Gràfics, SmartArt i objectes OLE
  • Animacions i transicions de diapositives
  • Exportació a PDF, HTML, SVG o formats d’imatge
  • Enllaços, configuracions d’acció, macros VBA i signatures digitals

Les parts XML desconegudes trobades durant la càrrega es conserven literalment en desar, de manera que els fitxers PPTX produïts per altres eines es tornen a processar de manera segura.

Vegeu també