Hướng Dẫn Nhà Phát Triển

Hướng dẫn này bao gồm các khả năng cốt lõi của Aspose.Slides FOSS cho Python với các ví dụ mã có thể chạy cho mỗi khu vực tính năng.

Trong Phần Này

TrangMô tả
Tính năng và Khả năngDanh sách đầy đủ các tính năng được hỗ trợ: slide, hình dạng, văn bản, tô màu, hiệu ứng, định dạng 3D, ghi chú, bình luận, hình ảnh và thuộc tính tài liệu.
Làm việc với Hình ảnhNhúng hình ảnh vào slide dưới dạng khung ảnh từ tệp hoặc byte; kiểm soát chế độ tô (kéo dài, lát gạch).
Làm việc với Kết nốiThêm các kết nối cong, góc khuỷu và thẳng giữa các hình dạng; thiết lập vị trí kết nối và kiểu đường.
Làm việc với Hiệu ứng 3DÁp dụng bóng ngoài, phát sáng, làm mờ, viền, cài đặt máy ảnh, bộ đèn và vật liệu cho các hình dạng.
Làm việc với Bình luậnThêm bình luận đánh giá dạng chuỗi và ghi chú người nói; quản lý tác giả bình luận; đọc chú thích.

Điểm vào API

Mỗi thao tác bắt đầu bằng một Presentation đối tượng. Luôn sử dụng nó như một trình quản lý ngữ cảnh:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

Trình quản lý ngữ cảnh đảm bảo các tài nguyên COM/XML nội bộ được giải phóng khi khối kết thúc. Không lưu trữ một Presentation tham chiếu bên ngoài with khối.

Định dạng đầu ra được hỗ trợ

Định dạng lưu duy nhất được hỗ trợ là PPTX (SaveFormat.PPTX). Xuất ra PDF, HTML, SVG, hoặc các định dạng hình ảnh không khả dụng trong phiên bản này.

Các lớp chính

Lớp / EnumĐường dẫn importMô tả
Presentationaspose.slides_fossBộ chứa gốc; dùng làm trình quản lý ngữ cảnh
ShapeTypeaspose.slides_fossEnum cho các loại hình dạng (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossEnum cho các kiểu tô (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossBool ba trạng thái cho định dạng (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportEnum định dạng đầu ra (chỉ hỗ trợ PPTX)
Coloraspose.slides_foss.drawingHàm tạo màu ARGB
PointFaspose.slides_foss.drawingĐiểm 2D kiểu float (được dùng cho vị trí bình luận)

Các hạn chế đã biết

Các khu vực sau gây ra NotImplementedError trong phiên bản này:

  • Biểu đồ: không tạo hoặc chỉnh sửa biểu đồ
  • SmartArt: không được hỗ trợ
  • Hoạt ảnh và chuyển tiếp: không thể đặt chuyển tiếp slide và hoạt ảnh đối tượng
  • Định dạng xuất: chỉ hỗ trợ lưu PPTX; không hỗ trợ xuất PDF, HTML, SVG, hoặc hình ảnh
  • Liên kết siêu văn bản và cài đặt hành động: các đối tượng liên kết không thể chỉnh sửa
  • Macro VBA và chữ ký số: không khả dụng

Các phần XML không xác định gặp trong quá trình tải sẽ được giữ nguyên khi lưu, vì vậy quá trình vòng lại không bao giờ xóa nội dung mà thư viện chưa hiểu.

Xem Thêm

 Tiếng Việt