چگونه اشکال را به پاورپوینت در پایتون اضافه کنیم
Aspose.Slides FOSS for Python از افزودن AutoShapes، Tables، Connectors و PictureFrames به اسلایدهای ارائه پشتیبانی میکند. تمام انواع شکلها از طریق مجموعه slide.shapes اضافه میشوند.
راهنمای گام به گام
مرحله ۱: نصب بسته
pip install aspose-slides-fossنصب را تأیید کنید:
import aspose.slides_foss as slides
print("Ready")مرحله ۲: ایجاد یک ارائه
همیشه از Presentation به عنوان مدیر زمینه استفاده کنید.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# ... add shapes ...
prs.save("output.pptx", SaveFormat.PPTX)مرحله ۳: افزودن یک AutoShape
slide.shapes.add_auto_shape(shape_type, x, y, width, height) یک شکل را در موقعیت و اندازهٔ دادهشده (همه به نقطه) قرار میدهد. برای انتخاب شکل از ثابتهای ShapeType استفاده کنید.
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]
# Rectangle
rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
rect.add_text_frame("Rectangle shape")
# Ellipse
ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 100)
ellipse.add_text_frame("Ellipse shape")
prs.save("autoshapes.pptx", SaveFormat.PPTX)مرحله ۴: افزودن جدول
slide.shapes.add_table(x, y, col_widths, row_heights) یک جدول در موقعیت مشخص ایجاد میکند. عرض ستونها و ارتفاع ردیفها لیستهایی از مقادیر نقطهای هستند.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
col_widths = [150.0, 150.0, 150.0]
row_heights = [40.0, 40.0, 40.0]
table = slide.shapes.add_table(50, 200, col_widths, row_heights)
# Set header row text
headers = ["Product", "Units", "Revenue"]
for col, text in enumerate(headers):
table.rows[0][col].text_frame.text = text
# Set data rows
rows = [
["Widget A", "120", "$2,400"],
["Widget B", "85", "$1,700"],
]
for row_idx, row_data in enumerate(rows):
for col, text in enumerate(row_data):
table.rows[row_idx + 1][col].text_frame.text = text
prs.save("table.pptx", SaveFormat.PPTX)مرحله 5: افزودن یک کانکتور
اتصالات دو شکل را به صورت بصری به هم متصل میکنند. ابتدا شکلها را ایجاد کنید، سپس یک اتصال اضافه کنید و نقاط اتصال شروع و پایان آن را تنظیم کنید.
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)
box1.add_text_frame("Start")
box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
box2.add_text_frame("End")
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 of box1
conn.end_shape_connected_to = box2
conn.end_shape_connection_site_index = 1 # left side of box2
prs.save("connector.pptx", SaveFormat.PPTX)شاخصهای نقاط اتصال برای یک مستطیل به صورت 0–3 شمارهگذاری میشوند: بالا=0، چپ=1، پایین=2، راست=3.
مرحله ۶: افزودن قاب تصویر
یک تصویر را جاسازی کنید و به اسلاید به عنوان PictureFrame اضافه کنید. ابتدا بایتهای تصویر را بخوانید، آنها را به مجموعهٔ تصاویر ارائه اضافه کنید، سپس فریم را ایجاد کنید.
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
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(
ShapeType.RECTANGLE, # bounding shape type
50, 50, # x, y in points
200, 150, # width, height in points
image
)
prs.save("with-image.pptx", SaveFormat.PPTX)مسائل رایج و راهحلها
شکل خارج از ناحیه قابل مشاهده اسلاید ظاهر میشود
اسلایدها بهصورت پیشفرض 720 × 540 نقطه هستند. مقادیر x یا y که خارج از این محدوده باشند، شکل را از اسلاید خارج میکنند. x < 720 و y < 540 را نگه دارید و اطمینان حاصل کنید x + width <= 720 و y + height <= 540.
AttributeError: 'NoneType' object has no attribute 'text_frame'
add_auto_shape() بهصورت مستقیم شیء شکل را برمیگرداند. اگر None را میبینید، بررسی کنید که مقدار بازگشتی را دور نمیاندازید.
متن سلول جدول پس از اختصاص خالی است
ویژگی صحیح .text_frame.text (نه .text مستقیماً روی سلول) است. سلولها را به صورت table.rows[row_index][col_index].text_frame.text = "value" دسترسی پیدا کنید.
سوالات متداول
چند شکل میتوانم به یک اسلاید اضافه کنم؟
هیچ محدودیتی توسط کتابخانه اعمال نمیشود. محدودیتهای عملی به اندازهٔ فایل و قابلیت رندرینگ نمایشگر PPTX هدف شما بستگی دارد.
آیا میتوانم موقعیت یک شکل را پس از افزودن آن تغییر دهم؟
بله. شیء shape که توسط add_auto_shape() برگردانده میشود، دارای ویژگیهای x، y، width و height است که میتوانید تنظیم کنید:
shape.x = 100
shape.y = 200
shape.width = 400
shape.height = 80آیا میتوانم رنگ خطمرز (حاشیه) شکل را تنظیم کنم؟
بله، از طریق shape.line_format:
from aspose.slides_foss.drawing import Color
shape.line_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)آیا نمودارها پشتیبانی میشوند؟
خیر. نمودارها، SmartArt و اشیاء OLE در این نسخه پیادهسازی نشدهاند و NotImplementedError را ایجاد میکنند.