תכונות ויכולות
תכונות ויכולות
Aspose.Slides FOSS for Python מספקת סט רחב של יכולות לעבודה עם קבצי 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, Tables ו-Connectors לשקופית.
צורות אוטומטיות
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
החל 3D bevel, camera, light rig, material, ו‑extrusion depth באמצעות 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: התייחסות למחלקות ולשיטות
- מדריכים איך-לעשות: מאמרים ממוקדי משימה