Najczęściej zadawane pytania

Jak zainstalować Aspose.Slides FOSS?

Dodaj zależność Maven do swojego pom.xml. Wymagana jest Java 21 lub nowsza.

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

Sprawdź instalację:

import org.aspose.slides.foss.Presentation;

Presentation prs = new Presentation();
try {
    System.out.println("Slides: " + prs.getSlides().size());
} finally {
    prs.dispose();
}

Nie wymaga Microsoft Office ani innych środowisk uruchomieniowych systemu.

Dlaczego muszę wywołać `dispose()` na Presentation?

Klasa Presentation zarządza wewnętrznymi zasobami pakietu OPC. Bez wywołania dispose() te zasoby nie są zwalniane, co może powodować wycieki pamięci lub blokady plików. Zawsze używaj try-finally:

Presentation prs = new Presentation("input.pptx");
try {
    // work here
    prs.save("output.pptx", SaveFormat.PPTX);
} finally {
    prs.dispose();
}

Alternatywnie, użyj try-with-resources, ponieważ Presentation implementuje AutoCloseable:

try (Presentation prs = new Presentation("input.pptx")) {
    prs.save("output.pptx", SaveFormat.PPTX);
}

Do jakich formatów plików mogę zapisać?

Obsługiwany jest tylko PPTX:

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

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

Eksport do PDF, HTML, SVG lub formatów obrazu (PNG, JPEG) nie jest dostępny w tej edycji.

Czy mogę otworzyć `.ppt` (stare pliki PowerPoint 97-2003)?

Nie. Obsługiwane są wyłącznie pliki .pptx (Office Open XML). Starszy format binarny .ppt nie jest obsługiwany przez tę bibliotekę.

Jak uzyskać dostęp do slajdów?

Slajdy są kolekcją zerowo‑indeksowaną dostępną przez prs.getSlides():

ISlide firstSlide = prs.getSlides().get(0);
int slideCount = prs.getSlides().size();

Jak dodać drugi slajd?

Użyj prs.getSlides().addEmptySlide() z układem:

try (Presentation prs = new Presentation()) {
    ILayoutSlide layout = prs.getLayoutSlides().get(0);
    prs.getSlides().addEmptySlide(layout);
    ISlide slide2 = prs.getSlides().get(1);
    prs.save("two-slides.pptx", SaveFormat.PPTX);
}

Jak ustawić kolor tła slajdu?

Kolor tła slajdu nie jest obsługiwany w tej edycji Aspose.Slides FOSS. Nie ma metody getBackground() w ISlide ani w żadnej innej klasie w tej bibliotece. Tło slajdu jest ustalone, gdy prezentacja jest tworzona z szablonu. Przyszła edycja może dodać kontrolę tła.

Jak używać `NullableBool`?

NullableBool jest wyliczeniem trójstanowym używanym do właściwości formatowania. Użyj NullableBool.TRUE (nie Java’owego true) do pogrubienia, kursywy i podobnych właściwości:

import org.aspose.slides.foss.NullableBool;

fmt.setFontBold(NullableBool.TRUE);
fmt.setFontItalic(NullableBool.FALSE);

Dlaczego ustawienie koloru tekstu nie ma żadnego efektu?

Musisz także ustawić fillType na FillType.SOLID przed przypisaniem koloru:

import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.drawing.Color;

fmt.getFillFormat().setFillType(FillType.SOLID);
fmt.getFillFormat().getSolidFillColor().setColor(Color.fromArgb(255, 200, 0, 0));

Czy mogę używać wykresów lub SmartArt?

Nie. Wykresy, SmartArt, obiekty OLE, animacje, przejścia, hiperłącza, makra VBA i podpisy cyfrowe nie są zaimplementowane w tej edycji i generują UnsupportedOperationException.

Czy biblioteka jest bezpieczna wątkowo?

Każdy obiekt Presentation jest niezależny. Tworzenie i używanie oddzielnych instancji Presentation z różnych wątków jest bezpieczne, o ile nie udostępniasz jednego obiektu Presentation pomiędzy wątkami bez zewnętrznej synchronizacji.

Jak osadzić obraz?

Odczytaj bajty obrazu i dodaj je do prs.getImages(), a następnie utwórz PictureFrame:

import org.aspose.slides.foss.ShapeType;

byte[] imageData = java.nio.file.Files.readAllBytes(
    java.nio.file.Paths.get("logo.png")
);
IPPImage image = prs.getImages().addImage(imageData);
slide.getShapes().addPictureFrame(ShapeType.RECTANGLE, 50, 50, 200, 150, image);

Najczęściej zadawane pytania