מדריך למפתחים

מדריך זה מכסה את היכולות המרכזיות של Aspose.Slides FOSS עבור Python עם דוגמאות קוד ניתנות להרצה עבור כל תחום תכונה.

בקטע זה

Page	Description
תכונות ויכולות	רשימה מלאה של תכונות נתמכות: שקופיות, צורות, טקסט, מילוי, אפקטים, עיצוב תלת‑ממדי, הערות, תגובות, תמונות, ותכונות מסמך.
עבודה עם תמונות	הטמעת תמונות בשקופיות כמסגרות תמונה מקובץ או מבייטים; שליטה במצב המילוי (מתיחה, ריצוף).
עבודה עם מחברים	הוספת מחברים כפופים, מרופדים וישרים בין צורות; הגדרת נקודות חיבור וסגנון קו.
עבודה עם אפקטים תלת‑ממדיים	החלת צל חיצוני, זוהר, טשטוש, חיתוך, הגדרות מצלמה מראש, מערכות תאורה וחומרים על צורות.
עבודה עם תגובות	הוספת תגובות ביקורת משורשרות והערות דובר; ניהול מחברי תגובות; קריאת אנוטציות.

נקודת כניסה של 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`	נקודת צף דו‑ממדית (משמשת למיקום הערות)

מגבלות ידועות

האזורים הבאים מייצרים NotImplementedError במהדורה זו:

Charts: אין יצירת גרפים או שינוי שלהם
SmartArt: לא נתמך
Animations and transitions: לא ניתן להגדיר מעברי שקופיות והנפשות של אובייקטים
Export formats: נתמך רק שמירת PPTX; אין ייצוא ל‑PDF, HTML, SVG או תמונות
Hyperlinks and action settings: אובייקטי קישורים אינם ניתנים לשינוי
VBA macros and digital signatures: לא נגישים

חלקי XML לא ידועים שנתקלים בהם במהלך הטעינה נשמרים במדויק בעת השמירה, ולכן תהליך העגינה חוזרת לעולם אינו מסיר תוכן שהספרייה עדיין אינה מבינה.

ראה גם

התחלה: התקנה והסקריפט הראשון
תיעוד API: תיעוד מחלקות ושיטות
מדריכים: מאמרים מעשיים ממוקדי משימה