תכונות ויכולות

תכונות ויכולות

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לא מיושם
טקסט מתמטילא מיושם

ראה גם

 עברית