תכונות ויכולות
תכונות ויכולות
Aspose.Slides FOSS for Python provides a broad set of capabilities for working with PowerPoint .pptx קבצים באופן תכנותי. דף זה מציג את כל תחומי הפונקציונליות הנתמכים עם דוגמאות קוד מייצגות.
קלט/פלט של מצגת
פתח קיים .pptx קובץ או צור חדש, ואז שמור חזרה בפורמט PPTX.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
# Open an existing presentation
with slides.Presentation("input.pptx") as prs:
print(f"Slide count: {len(prs.slides)}")
prs.save("output.pptx", SaveFormat.PPTX)
# Create a new presentation (starts with one blank slide)
with slides.Presentation() as prs:
prs.save("new.pptx", SaveFormat.PPTX)הערה: PPTX הוא הפורמט היחיד הנתמך לשמירה. ייצוא ל‑PDF, HTML, SVG או תמונות אינו זמין.
חלקי XML לא ידועים בקובץ המקור נשמרים במדויק בעת השמירה, ולכן פתיחה ושמירה מחדש של .pptx לעולם לא יגרעו תוכן שהספרייה עדיין אינה מבינה.
ניהול שקופיות
הוסף, הסר, שכפל וסדר מחדש שקופיות.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
# Access the first slide
slide = prs.slides[0]
# Add an additional blank slide at the end
prs.slides.add_empty_slide(prs.layout_slides[0])
print(f"Total slides: {len(prs.slides)}")
prs.save("multi-slide.pptx", SaveFormat.PPTX)צורות
הוסף AutoShapes, PictureFrames, טבלאות ומחברים לשקופית.
AutoShapes
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# Add a rectangle at (x=50, y=50) with width=300, height=100
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
shape.add_text_frame("Aspose.Slides FOSS")
prs.save("shapes.pptx", SaveFormat.PPTX)טבלאות
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# Column widths and row heights in points
col_widths = [120.0, 120.0, 120.0]
row_heights = [40.0, 40.0, 40.0]
table = slide.shapes.add_table(50, 50, col_widths, row_heights)
table.rows[0][0].text_frame.text = "Product"
table.rows[0][1].text_frame.text = "Quantity"
table.rows[0][2].text_frame.text = "Price"
prs.save("table.pptx", SaveFormat.PPTX)מחברים
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
box1 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 100, 150, 60)
box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
conn = slide.shapes.add_connector(ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)
conn.start_shape_connected_to = box1
conn.start_shape_connection_site_index = 3 # right side
conn.end_shape_connected_to = box2
conn.end_shape_connection_site_index = 1 # left side
prs.save("connector.pptx", SaveFormat.PPTX)עיצוב טקסט
עצב טקסט ברמת פסקה ותו באמצעות PortionFormat.
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
tf = shape.add_text_frame("Bold blue heading")
fmt = tf.paragraphs[0].portions[0].portion_format
fmt.font_height = 28
fmt.font_bold = NullableBool.TRUE
fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)
prs.save("text.pptx", SaveFormat.PPTX)NullableBool.TRUE מגדיר את המאפיין במפורש; NullableBool.NOT_DEFINED יורש ממאסטר השקופית.
סוגי מילוי
החל מילויים מוצקים, מדרגיים, תבניתיים או תמונה על צורות.
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 150)
# Solid fill
shape.fill_format.fill_type = FillType.SOLID
shape.fill_format.solid_fill_color.color = Color.from_argb(255, 30, 120, 200)
prs.save("fill.pptx", SaveFormat.PPTX)אפקטים חזותיים
החל צל חיצוני, זוהר, קצה רך, טשטוש, השתקפות וצל פנימי על צורות.
מאפייני האפקט נגישים דרך shape.effect_format. הגדר outer_shadow_effect, glow_effect, soft_edge_effect, blur_effect, reflection_effect, או inner_shadow_effect כדי להגדיר כל אחד בנפרד.
3D Formatting
החל חיתוך תלת‑ממדי, מצלמה, מערכת תאורה, חומר ועומק חצייה באמצעות shape.three_d_format. זה שולט בעומק הוויזואלי ובמודל התאורה עבור רינדור צורות במציגי PPTX התומכים באפקטים תלת‑ממדיים.
הערות מציג
הצמד הערות לכל שקף באמצעות notes_slide_manager.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
notes = prs.slides[0].notes_slide_manager.add_notes_slide()
notes.notes_text_frame.text = "Key talking point: emphasize the ROI benefit."
prs.save("notes.pptx", SaveFormat.PPTX)הערות
הוסף הערות משורשרות עם מידע על המחבר ומיקום השקף.
import aspose.slides_foss as slides
from aspose.slides_foss.drawing import PointF
from aspose.slides_foss.export import SaveFormat
from datetime import datetime
with slides.Presentation() as prs:
author = prs.comment_authors.add_author("Jane Smith", "JS")
slide = prs.slides[0]
author.comments.add_comment(
"Please verify this data before the presentation.",
slide,
PointF(2.0, 2.0),
datetime.now()
)
prs.save("comments.pptx", SaveFormat.PPTX)תמונות משובצות
הטמע תמונה מנתיב קובץ במצגת והוסף אותה לשקף כ PictureFrame.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
with open("logo.png", "rb") as f:
image_data = f.read()
image = prs.images.add_image(image_data)
slide = prs.slides[0]
slide.shapes.add_picture_frame(
slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image
)
prs.save("with-image.pptx", SaveFormat.PPTX)מאפייני מסמך
קרא וכתוב מאפייני מסמך בסיסיים, של האפליקציה והמותאמים אישית.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
props = prs.document_properties
# Core properties
props.title = "Q1 Results"
props.author = "Finance Team"
props.subject = "Quarterly Review"
props.keywords = "Q1, finance, results"
# Custom property
props.set_custom_property_value("ReviewedBy", "Legal Team")
prs.save("deck.pptx", SaveFormat.PPTX)מגבלות ידועות
האזורים הבאים מייצרים NotImplementedError ואינם זמינים בגרסה זו:
| אזור | סטטוס |
|---|---|
| תרשימים | לא מיושם |
| SmartArt | לא מיושם |
| הנפשות ומעברים | לא מיושם |
| ייצוא PDF / HTML / SVG / תמונה | לא מיושם (רק PPTX) |
| מאקרו VBA | לא מיושם |
| חתימות דיגיטליות | לא מיושם |
| קישורים והגדרות פעולה | לא מיושם |
| אובייקטי OLE | לא מיושם |
| טקסט מתמטי | לא מיושם |
ראה גם
- התחלה: התקנה ותסריט ראשון
- תיעוד API: התייחסות למחלקה ולמתודה
- מדריכים איך לעשות: מאמרים ממוקדי משימה