Основна API на Aspose.Slides FOSS за Java

Въведение

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 Заглавие: Java 21 и по-горе.

Проектът е пуснат под лиценза на MIT, така че можете да го използвате както в лични, так и търговски проекти без никакви разходи и с API ключ. Той осигурява богат модел за обекти за сливи, форми, текст, таблици, изображения, коментари и документи свойства, подкрепени от директна манипулация на формат на Office Open XML пакет.

С 273 класове, над 2600 методи и 42 списъци основният API обхваща блоковете на строителството, от които се нуждаете, за да автоматизирате работните потоци за представяне във всяка Java приложение.

Какво е включено

Презентация за жизнения цикъл

и на Presentation клас е входната точка за всяка операция. можете да създадете бяла презентация и да съхранявате резултата на диска или на OutputStream в различни формати. класът имплементира AutoCloseable, така че работи естествено с 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);
}

Слайд мениджмънт

SlideCollection осигурява пълен контрол над слайд дек. Можете да добавите бял слейд с addEmptySlide(),- Да се удвои съществуващ слайд addClone(),Включете в него специален индекс с insertEmptySlide(), премахване на слайдове по референтност или индекс, и iterate над колекцията.

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

Форми и автоматериали

и на AutoShape клас представлява най-често срещания извличащ обект на слайд. Вие създавате форми чрез IShapeCollection.addAutoShape(),Посочвайки A ShapeType Постоянно (като например ShapeType.RECTANGLEКоординати на позициите - всеки от тях. AutoShape Излагане на A TextFrame За съдържанието на текстовете и за FillFormat За визуален стил.

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

Текст и параграфи

Иракът е изразена като йерархия на TextFrame, ParagraphCollection, Paragraph, PortionCollection,и Portion Можете да зададете плосък текст на рамка директно с TextFrame.setText(), или изграждане на многопроводните параграфи чрез добавяне на индивидуални Portion Примери с различен формат.

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

Документални свойства

и на DocumentProperties клас излага стандартни метаданни полета като заглавие, автор, предмет, ключови думи, категория и часовни знаци. свойствата са постоянни в ядрото на PPTX и разширени свойства части и оцеляват кръг-трип съхранение / презареждане цикли.

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

Коментари и анотации

Подсистемата за коментари включва CommentAuthorCollection и CommentCollection.Можете да добавите автори, да приложите коментари към конкретни слайдове и позиции и да прочетете съществуващите бележки. ppt/commentAuthors.xml и ppt/comments/*.xml Части от пакета PPTX.

Бързо стартиране

Добавете зависимостта на Maven към вашата pom.xml:

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

След това създайте и съхранявайте презентация:

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

Подкрепени формати

и на SaveFormat списък определя всеки формат на изхода, който библиотеката може да напише. таблицата по-долу показва потвърдените записи.

Забележка : В момента се прилага само експортът на PPTX. Другите стойности на формата съществуват в SaveFormat еум за напредна съвместимост, но все още не са функционални. save() методът винаги произвежда PPTX изход, независимо от параметъра на формата.

Отворени източници и лицензиране

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.Вие сте свободни да използвате, модифицирате и преразпределяте библиотеката във всеки проект без роялти или лицензионни ключове.

Започваме

Ето и следните ресурси, които ще ви помогнат да започнете:

• Разработчик ръководство - Пътеводи и туториали за всяка област на функционалността
• Знание база Как да пишете статии и често задавани въпроси
• Огнено референтно - пълна класа и методична документация