افزودن مستطیل‌ها به ارائه‌ها در Python از طریق Java

نمای کلی

این مقاله نشان می‌دهد چگونه با استفاده از Aspose.Slides اشکال مستطیلی را به اسلایدهای PowerPoint اضافه کنید. این مقاله ایجاد یک مستطیل ساده، ایجاد یک مستطیل قالب‌بندی‌شده، و ذخیرهٔ ارائه به‌روز شده به صورت فایل PPTX را پوشش می‌دهد.

همچنین خواهید دید چگونه قالب‌بندی پایهٔ مستطیل، مانند رنگ پرشدن یکدست، رنگ خط و ضخامت خط را اعمال کنید. علاوه بر این، بخش پرسش‌های متداول مقاله به کارهای مرتبط با مستطیل اشاره می‌کند، از جمله گوشه‌های گرد، پرکردن با تصویر، جلوه‌های بصری، پیوندهای ابرمتنی، قفل‌کردن شکل، گزینه‌های صادرات و ویژگی‌های مؤثر.

اضافه کردن یک مستطیل به اسلاید

برای اضافه کردن یک مستطیل ساده به اسلایدی انتخاب‌شده در ارائه، مراحل زیر را دنبال کنید:

  • یک نمونه از کلاس Presentation ایجاد کنید.
  • یک ارجاع به اسلاید را بر اساس ایندکس آن دریافت کنید.
  • یک AutoShape از نوع مستطیل را با استفاده از متد addAutoShape که توسط شیء ShapeCollection فراهم می‌شود، اضافه کنید.
  • ارائهٔ تغییر یافته را به عنوان یک فایل PPTX بنویسید.

در مثال زیر، یک مستطیل ساده به اولین اسلاید ارائه اضافه شده است.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType

# نمونه‌سازی کلاس Presentation که نشانگر فایل PPTX است.
presentation = Presentation()
try:
    # دریافت اولین اسلاید.
    slide = presentation.getSlides().get_Item(0)

    # افزودن یک شکل مستطیل.
    slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50)

    # نوشتن فایل PPTX به دیسک.
    presentation.save("RecShp1.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

اضافه کردن یک مستطیل قالب‌بندی‌شده به اسلاید

برای اضافه کردن یک مستطیل قالب‌بندی‌شده به اسلاید، مراحل زیر را دنبال کنید:

  • یک نمونه از کلاس Presentation ایجاد کنید.
  • یک ارجاع به اسلاید را بر اساس ایندکس آن دریافت کنید.
  • یک AutoShape از نوع مستطیل را با استفاده از متد addAutoShape که توسط شیء ShapeCollection فراهم می‌شود، اضافه کنید.
  • نوع fill type مستطیل را به solid تنظیم کنید.
  • رنگ مستطیل را با استفاده از متد setColor روی رنگ پرشدن یکدست شیء FillFormat مرتبط با شیء Shape تنظیم کنید.
  • رنگ خط مرزی مستطیل را تنظیم کنید.
  • عرض خط مرزی مستطیل را تنظیم کنید.
  • ارائهٔ تغییر یافته را به عنوان یک فایل PPTX بنویسید.

مراحل فوق در مثال زیر پیاده‌سازی شده‌اند.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

# نمونه‌سازی کلاس Presentation که نشانگر فایل PPTX است.
presentation = Presentation()
try:
    # دریافت اولین اسلاید.
    slide = presentation.getSlides().get_Item(0)

    # افزودن یک شکل مستطیل.
    rectangle = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50)

    # قالب‌بندی پرشدن مستطیل.
    rectangle.getFillFormat().setFillType(FillType.Solid)
    rectangle.getFillFormat().getSolidFillColor().setColor(Color.GRAY)

    # قالب‌بندی خط مرزی مستطیل.
    rectangle.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    rectangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    rectangle.getLineFormat().setWidth(5)

    # نوشتن فایل PPTX به دیسک.
    presentation.save("RecShp2.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

سوالات متداول

چگونه یک مستطیل با گوشه‌های گرد اضافه کنم؟

از نوع شکل shape type با گوشه‌های گرد استفاده کنید و شعاع گوشه‌ها را در ویژگی‌های شکل تنظیم کنید؛ گرد کردن می‌تواند به‌صورت جداگانه برای هر گوشه از طریق تنظیمات هندسی نیز اعمال شود.

چگونه یک مستطیل را با تصویر (بافت) پر کنم؟

نوع پرکردن تصویر fill type را انتخاب کنید، منبع تصویر را ارائه دهید و حالت‌های کشیدن/کاشی stretching/tiling modes را پیکربندی کنید.

آیا می‌توان یک مستطیل را سایه‌دار و درخشان کرد؟

بله. سایهٔ بیرونی/درونی، درخشندگی و لبه‌های نرم در دسترس هستند و می‌توان پارامترهای آن‌ها را تنظیم کرد.

آیا می‌توانم مستطیل را به دکمه‌ای با پیوند ابرمتنی تبدیل کنم؟

بله. می‌توانید پیوند ابرمتنی را به کلیک روی شکل اختصاص دهید (رفتن به اسلاید، فایل، آدرس وب یا ایمیل).

چگونه می‌توانم از جابجایی و تغییرات مستطیل محافظت کنم؟

از قفل‌کردن شکل استفاده کنید: می‌توانید جابجایی، تغییر اندازه، انتخاب یا ویرایش متن را ممنوع کنید تا طرح حفظ شود.

آیا می‌توانم مستطیل را به تصویر راستری یا SVG تبدیل کنم؟

بله. می‌توانید شکل را رندر کنید و به تصویر با اندازه/مقیاس مشخص تبدیل کنید یا آن را به صورت SVG صادر کنید برای استفادهٔ برداری.

چگونه می‌توانم به‌سرعت ویژگی‌های واقعی (effective) یک مستطیل را با در نظر گرفتن تم و ارث‌بری به‌دست آورم؟

از ویژگی‌های مؤثر شکل استفاده کنید: API مقادیر محاسبه‌شده‌ای را برمی‌گرداند که سبک‌های تم، لایه‌بندی و تنظیمات محلی را دربر می‌گیرد و تحلیل قالب‌بندی را ساده می‌کند.