API cốt lõi của Aspose.Slides FOSS cho Java

Introduction

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 gói và mục tiêu Java 21 và trên.

Dự án được phát hành theo giấy phép MIT, vì vậy bạn có thể sử dụng nó trong cả các dự án cá nhân và thương mại mà không có chi phí và với bất kỳ API khóa. Nó cung cấp lớp học cho hình ảnh, hình dạng, văn bản, bảng, ảnh và tài liệu thuộc tính, hỗ trợ bởi thao tác trực tiếp của định dạng gói Office Open XML.

Với 273 lớp học, hơn 2.600 phương pháp và 42 danh sách, API cốt lõi bao gồm các khối xây dựng bạn cần để tự động hóa dòng công việc trình bày trong bất kỳ ứng dụng Java nào.

Những gì được bao gồm

Giới thiệu LIFECYCLE

Các Presentation lớp là điểm đầu vào cho mỗi hoạt động. bạn có thể tạo một bản trình bày trắng và lưu kết quả trên đĩa hoặc trên một OutputStream trong một loạt các định dạng. lớp thực hiện AutoCloseable, vì vậy nó hoạt động tự nhiên với các khối nguồn cố gắng.

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

Quản lý Slide

SlideCollection Cho phép bạn thêm các slides trắng với addEmptySlide(), duplicate các slides hiện có với addClone(), nhập slides vào một chỉ số cụ thể với insertEmptySlide(), loại bỏ các nhấp chuột bằng tham chiếu hoặc chỉ số, và iterate trên bộ sưu tập.

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

Hình dạng và AutoShapes

Các AutoShape lớp đại diện cho đối tượng thu được phổ biến nhất trên một tấm. bạn tạo các hình dạng thông qua IShapeCollection.addAutoShape(), xác định A ShapeType (Công thức thường xuyên như ShapeType.RECTANGLE- Các định vị và các điều phối vị trí. mỗi AutoShape Hiển thị A TextFrame Đối với nội dung văn bản và a FillFormat cho visual styling.

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

Text và Paragraphs

Văn bản giàu có được mô hình như một hiến pháp của TextFrame, ParagraphCollection, Paragraph, PortionCollection, và Portion - Objects. bạn có thể đặt văn bản thẳng trên một khung trực tiếp với TextFrame.setText(), hoặc xây dựng các đoạn đa chạy bằng cách thêm cá nhân Portion Các trường hợp với định dạng khác nhau.

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

Tài liệu tài sản

Các DocumentProperties lớp tiết lộ các trường metadata tiêu chuẩn như tiêu đề, tác giả, chủ đề , từ khóa, thể loại và thời gian. thuộc tính được giữ trong phần bản gốc PPTX và mở rộng thuộc sản và sống sót vòng-trip lưu / tải lại chu kỳ.

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

Comments & Annotications

Các bình luận dưới hệ thống bao gồm CommentAuthorCollection và CommentCollection.Bạn có thể thêm tác giả, thêm bình luận vào các nhãn hiệu và vị trí cụ thể, và đọc lại các ghi chú hiện tại. dữ liệu bình báo được giữ trong phần bình chọn của gói PPTX và tồn tại vòng quay lưu / tải về chu kỳ.

Khởi động nhanh

Thêm phụ thuộc Maven sau đây vào bạn pom.xml để bao gồm Aspose.Slides FOSS for Java trong dự án của bạn:

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

Sau đó tạo và lưu một bản trình bày:

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

Các định dạng hỗ trợ

Các SaveFormat Danh sách xác định mỗi định dạng xuất khẩu mà thư viện có thể viết. bảng dưới đây liệt kê các bài đăng được xác nhận.

Lưu ý : PPTX xuất khẩu được thực hiện đầy đủ. khác SaveFormat các giá trị enum (PPT, ODP, PDF, PNG, vv) được xác định cho tương thích trong tương lai và sẽ có chức năng trong các phát hành trong năm tới; chuyển chúng sang save() Hiện tại sản xuất PPTX.

Open Source & Giấy phép

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.Bạn có thể sử dụng, sửa đổi và phân phối lại thư viện trong bất kỳ dự án nào mà không cần mã hóa hoặc khóa giấy phép.

bắt đầu

Chuẩn bị để lặn sâu hơn? đây là các nguồn lực để giúp bạn bắt đầu:

• Hướng dẫn Developer - Các bước đi và hướng dẫn cho mỗi khu vực tính năng
• Cơ sở kiến thức - Làm thế nào để viết bài và thường xuyên hỏi câu hỏi
• API tham chiếu - Tài liệu lớp học và phương pháp đầy đủ

Tài nguyên liên quan

• Aspose.Slides — Enterprise Blog