คู่มือผู้พัฒนา
This guide covers the core capabilities of Aspose.Slides FOSS for Python with runnable code examples for each feature area.
ในส่วนนี้
| หน้า | คำอธิบาย |
|---|---|
| คุณลักษณะและความสามารถ | รายการเต็มของคุณลักษณะที่รองรับ: สไลด์, รูปร่าง, ข้อความ, การเติม, เอฟเฟกต์, การจัดรูปแบบ 3D, โน้ต, ความคิดเห็น, รูปภาพ, และคุณสมบัติของเอกสาร. |
| การทำงานกับรูปภาพ | ฝังรูปภาพลงในสไลด์เป็นกรอบภาพจากไฟล์หรือไบต์; ควบคุมโหมดการเติม (ขยาย, กระเบื้อง). |
| การทำงานกับตัวเชื่อม | เพิ่มตัวเชื่อมแบบโค้ง, แบบศอก, และแบบตรงระหว่างรูปร่าง; ตั้งตำแหน่งการเชื่อมต่อและสไตล์เส้น. |
| การทำงานกับเอฟเฟกต์ 3D | ใช้เงานอก, แสงเรืองแสง, เบลอ, แบเวล, การตั้งค่ากล้อง, ระบบแสง, และวัสดุต่าง ๆ กับรูปร่าง. |
| การทำงานกับความคิดเห็น | เพิ่มความคิดเห็นแบบเธรดและโน้ตผู้พูด; จัดการผู้เขียนความคิดเห็น; อ่านคำอธิบายประกอบ. |
จุดเริ่มต้นของ API
ทุกการดำเนินการเริ่มต้นด้วย Presentation อ็อบเจ็กต์. ใช้มันเสมอเป็นตัวจัดการบริบท:
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)ตัวจัดการบริบทรับประกันว่าทรัพยากร COM/XML ภายในจะถูกปล่อยเมื่อบล็อกสิ้นสุด. อย่าเก็บ Presentation อ้างอิงนอกเหนือจาก with บล็อก.
รูปแบบการส่งออกที่รองรับ
รูปแบบการบันทึกที่รองรับเพียงอย่างเดียวคือ PPTX (SaveFormat.PPTX). การส่งออกเป็น PDF, HTML, SVG หรือรูปแบบภาพไม่พร้อมใช้งานในฉบับนี้.
คลาสสำคัญ
| คลาส / Enum | เส้นทางการนำเข้า | คำอธิบาย |
|---|---|---|
Presentation | aspose.slides_foss | คอนเทนเนอร์ราก; ใช้เป็นตัวจัดการบริบท |
ShapeType | aspose.slides_foss | Enum สำหรับประเภทรูปทรง (RECTANGLE, ELLIPSE, …) |
FillType | aspose.slides_foss | Enum สำหรับประเภทการเติม (SOLID, GRADIENT, …) |
NullableBool | aspose.slides_foss | บูลีนสามสถานะสำหรับการจัดรูปแบบ (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | aspose.slides_foss.export | Enum รูปแบบผลลัพธ์ (รองรับเฉพาะ PPTX) |
Color | aspose.slides_foss.drawing | คอนสตรัคเตอร์สี ARGB |
PointF | aspose.slides_foss.drawing | จุด 2D แบบ float (ใช้สำหรับตำแหน่งคอมเมนต์) |
ข้อจำกัดที่ทราบ
ส่วนต่อไปนี้ทำให้เกิด NotImplementedError ในรุ่นนี้:
- แผนภูมิ: ไม่สามารถสร้างหรือแก้ไขแผนภูมิได้
- SmartArt: ไม่รองรับ
- การเคลื่อนไหวและการเปลี่ยนภาพ: ไม่สามารถตั้งค่าการเปลี่ยนภาพสไลด์และการเคลื่อนไหวของวัตถุได้
- รูปแบบการส่งออก: รองรับการบันทึกเป็น PPTX เท่านั้น; ไม่รองรับ PDF, HTML, SVG หรือการส่งออกเป็นภาพ
- ไฮเปอร์ลิงก์และการตั้งค่าการกระทำ: ไม่สามารถแก้ไขวัตถุลิงก์ได้
- มาโคร VBA และลายเซ็นดิจิทัล: ไม่สามารถเข้าถึงได้
ส่วน XML ที่ไม่รู้จักที่พบระหว่างการโหลดจะถูกเก็บไว้ตามต้นฉบับเมื่อตอนบันทึก ดังนั้นการวนรอบจะไม่ลบเนื้อหาที่ไลบรารียังไม่เข้าใจ.
ดูเพิ่มเติม
- เริ่มต้น: การติดตั้งและสคริปต์แรก
- อ้างอิง API: การอ้างอิงคลาสและเมธอด
- คู่มือวิธีทำ: บทความวิธีทำเชิงงาน