Как да създавате презентации в Java

Aspose.Slides FOSS for Java ви позволява да създавате PowerPoint презентации изцяло на Java без зависимост от Microsoft Office. Това ръководство показва как да създадете нова презентация, да добавите слайдове и форми, да форматирате текст и да запазите резултата.

Ръководство стъпка по стъпка

Стъпка 1: Добавете Maven зависимост

Добавете Aspose.Slides FOSS към вашия pom.xml. Необходим е Java 21 или по‑нова версия.

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

Проверете инсталацията:

import org.aspose.slides.foss.Presentation;

Presentation prs = new Presentation();
prs.dispose();
System.out.println("Aspose.Slides FOSS ready");

Стъпка 2: Импортиране на необходимите класове

Импортирайте класа Presentation и enum SaveFormat, необходими за запазване.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;

Всички константи за типове форми се намират в org.aspose.slides.foss.ShapeType. Форматиращите изброявания (FillType, NullableBool) също са в org.aspose.slides.foss.

Стъпка 3: Създаване на презентация

Използвайте new Presentation() и го обвийте в try-with-resources. Нова презентация започва с един празен слайд.

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

try (Presentation prs = new Presentation()) {
    System.out.println("Slides in new presentation: " + prs.getSlides().size());
    prs.save("output.pptx", SaveFormat.PPTX);
}

Важно: Винаги използвайте try-with-resources или извикайте prs.dispose() в блок finally. В противен случай ресурсите няма да бъдат освободени правилно.

Стъпка 4: Достъп до слайд

Първият слайд е с индекс 0. Празна презентация има точно един слайд.

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);  // zero-based index
    System.out.println("Slide at index 0: " + slide);
    prs.save("output.pptx", SaveFormat.PPTX);
}

Стъпка 5: Добавяне на форма

Използвайте slide.getShapes().addAutoShape(), за да добавите AutoShape. Параметрите са (shapeType, x, y, width, height), всички в точки (1 точка = 1/72 инча; стандартният слайд е 720 × 540 pt).

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.ITable;
import org.aspose.slides.foss.ILayoutSlide;
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()) {
    ISlide slide = prs.getSlides().get(0);

    // Rectangle at (50, 50) with 400 wide and 120 tall
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 120
    );

    // Attach a text frame
    shape.addTextFrame("Hello from Aspose.Slides FOSS!");

    prs.save("with-shape.pptx", SaveFormat.PPTX);
}

Стъпка 6: Запазване на презентацията

Извикайте prs.save(path, SaveFormat.PPTX) преди блокът try да излезе. PPTX е единственият поддържан изходен формат.

prs.save("result.pptx", SaveFormat.PPTX);

Файлът се записва атомарно; ако възникне грешка преди това извикване, не се създава изходен файл.

Пълен работен пример

Следната програма създава презентация от два слайда със заглавна форма на първия слайд и таблица на втория.

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.ITable;
import org.aspose.slides.foss.ILayoutSlide;
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 CreatePresentation {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            // --- Slide 1: title shape ---
            ISlide slide1 = prs.getSlides().get(0);
            IAutoShape title = slide1.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 40, 40, 640, 80
            );
            ITextFrame tf = title.addTextFrame("Q1 Results: Executive Summary");
            IPortionFormat fmt = tf.getParagraphs().get(0)
                .getPortions().get(0).getPortionFormat();
            fmt.setFontHeight(32);
            fmt.setFontBold(NullableBool.TRUE);
            fmt.getFillFormat().setFillType(FillType.SOLID);
            fmt.getFillFormat().getSolidFillColor().setColor(
                Color.fromArgb(255, 0, 70, 127)
            );

            // --- Slide 2: table ---
            prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
            ISlide slide2 = prs.getSlides().get(1);
            ITable table = slide2.getShapes().addTable(
                40, 40,
                new double[]{200.0, 120.0, 120.0},
                new double[]{40.0, 40.0, 40.0}
            );
            String[] headers = {"Region", "Revenue", "Growth"};
            String[][] data = {
                {"North", "$1.2M", "+8%"},
                {"South", "$0.9M", "+4%"},
            };
            for (int col = 0; col < headers.length; col++) {
                table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
            }
            for (int row = 0; row < data.length; row++) {
                for (int col = 0; col < data[row].length; col++) {
                    table.getRows().get(row + 1).get(col)
                        .getTextFrame().setText(data[row][col]);
                }
            }

            prs.save("q1-results.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved q1-results.pptx");
    }
}

Общи проблеми и решения

IllegalStateException: Presentation already disposed

Вие извиквате методи върху обект Presentation след като блокът try-with-resources е излязъл. Винаги изпълнявайте цялата работа в блока try.

UnsupportedOperationException при запазване

Това се случва, когато се опитвате да запазите в формат, различен от PPTX, или когато използвате неподдържана функция (като диаграми или анимации).

Фигурата се появява извън видимата област на слайда

Слайдовете по подразбиране са 720 × 540 точки. Запазете x + width <= 720 и y + height <= 540.

Често задавани въпроси

Какъв е размерът по подразбиране на слайда?

Новият Presentation() създава слайдове със стандартен размер 10 × 7,5 инча (720 × 540 точки). Промяната на размера на слайда все още не се поддържа в това издание.

Мога ли да добавя повече от един слайд?

Да. Извикайте prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0)), за да добавите празен слайд и да го достъпите по индекс:

prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
ISlide slide2 = prs.getSlides().get(1);

Мога ли да отворя съществуващ файл и да добавя слайдове?

Да:

try (Presentation prs = new Presentation("existing.pptx")) {
    prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
    prs.save("existing.pptx", SaveFormat.PPTX);
}

Какви формати мога да запазя?

Поддържа се само SaveFormat.PPTX. Експортирането в PDF, HTML, SVG или изображения не е налично в това издание.