API de Aspose.Slides FOSS para Java

Introducción

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 El paquete y los objetivos de Java 21 y superior.

El proyecto se libera bajo la licencia MIT, por lo que puede utilizarlo en proyectos personales y comerciales sin costo y sin clave API. proporciona clases para las imágenes, formas, texto, tablas, imágenes y propiedades de documento, apoyadas por manipulación directa del formato de paquete XML de Office Open.

Con 273 clases, más de 2.600 métodos y 42 enumerations, la API principal cubre los bloques de construcción que necesitas para automatizar flujos de trabajo de presentación en cualquier aplicación Java.

Lo que está incluido

Presentación Ciclo de Vida

El Presentation clase es el punto de entrada para cada operación.Puede crear una presentación blanca y salvar el resultado en un disco o en una OutputStream en varios formatos. la clase implantación AutoCloseable, así que funciona de manera natural con los bloques de recursos try-with.

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

Gestión de Slide

SlideCollection que te permita añadir las pantallas blancas con addEmptySlide(),duplicar los eslavos existentes con addClone(), insertar las pistas en un índice específico con insertEmptySlide(), eliminar las pistas por referencia o índice, y iterar sobre la colección.

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

Forma y autoformaciones

El AutoShape clase es el objeto más común que se puede extraer en una slide. IShapeCollection.addAutoShape(),especificando a ShapeType Constante (como el ShapeType.RECTANGLEy las coordenadas de posición. cada uno AutoShape Exponer a TextFrame para el contenido y a FillFormat para el estil visual.

try (Presentation pres = new Presentation()) {
    var 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());
}

Texto y Parágrafos

El texto rico se modeló como una jerarquía de TextFrame, ParagraphCollection, Paragraph, PortionCollection,y, Portion Objetos. puede configurar texto plano en un marco directamente con el TextFrame.setText(), o crear parágrafos multi-run al agregar individuales Portion de los distintos formatos.

try (Presentation pres = new Presentation()) {
    var 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());
}

Propiedades de documentos

El DocumentProperties Las clases exponen campos de metadatos estándar como título, autor, tema, palabras clave, categoría y timestamps. las propiedades se persisten en el núcleo PPTX y partes de propiedad extendida y sobreviven ciclos redondeados de ahorro/reload.

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

Comentarios y Anotaciones

El subsistema de comentarios incluye CommentAuthorCollection y CommentCollection.Puedes agregar autores, añadir comentarios a las pistas y posiciones específicas, y leer de nuevo los anotaciones existentes. Los datos de comentarios se persisten en las partes de comentario del paquete PPTX y sobreviven ciclos redondos de ahorro/reload.

Inicio rápido

Añade la siguiente dependencia de Maven a tu pom.xml para incluir Aspose.Slides FOSS para Java en su proyecto:

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

Crea y salva una presentación:

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

Formatos apoyados

El SaveFormat La enumeración define cada formato de salida que la biblioteca puede escribir.La tabla debajo lista las entradas confirmadas.

Nota de: La exportación de PPTX se está implementando plenamente.Otros SaveFormat Los valores enum (PPT, ODP, PDF, PNG, etc.) se definen para la compatibilidad a futuro y serán funcionales en futuras publicaciones; los transponerán a las siguientes: save() Actualmente produce PPTX.

Open Source y Licenciación

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.Usted es libre de usar, modificar y redistribuir la biblioteca en cualquier proyecto sin royalties o las claves de licencia.

Empezando a

¿Estás dispuesto a mergullar más profundamente?Aquí están los recursos que te ayudarán a comenzar:

• Guía de desarrollador - Pasajes y tutoriales para cada área de características
• Base de conocimientos - Cómo escribir artículos y preguntas frecuentes
• El referente de API - Documentación de clase y método completo

Recursos relacionados

• Aspose.Slides — Enterprise Blog