مدیریت راهنماهای رسم در ارائهها با پایتون
بررسی کلی
راهنماهای رسم خطوط قابل تنظیم افقی و عمودی هستند که به کاربران کمک میکنند تا اشکال را بهصورت یکنواخت در حین ویرایش یک ارائه در PowerPoint همراستا کنند. این راهنماها بهویژه زمانی مفید هستند که یک برنامه یک ارائه را تولید میکند که بعداً بهصورت دستی اصلاح میشود: برنامه میتواند همان کمکهای همراستایی را ذخیره کند تا نویسندگان هنگام افزودن یا جابهجایی محتوا از آنها پیروی کنند.
راهنماهای رسم ابزارهای ویرایشی هستند، نه محتوای اسلاید. آنها در نمایش اسلاید یا خروجی رندر شده ظاهر نمیشوند. Aspose.Slides برای Python از طریق .NET آنها را از طریق رابط IDrawingGuidesCollection در دسترس قرار میدهد. یک راهنما توسط IDrawingGuide نمایش داده میشود و دارای جهت، موقعیت و رنگ است.
موقعیت بر حسب نقطه از گوشه بالا‑چپ اسلاید یا مستر مربوطه اندازهگیری میشود. یک راهنمای عمودی از مختصات افقی استفاده میکند که معمولاً بین صفر و عرض اسلاید است. یک راهنمای افقی از مختصات عمودی استفاده میکند که معمولاً بین صفر و ارتفاع اسلاید است.
افزودن راهنماها به نمای اسلاید
از ICommonSlideViewProperties.drawing_guides برای مدیریت راهنماهایی که در حین ویرایش اسلایدهای عادی نمایش داده میشوند استفاده کنید. با مقدار Orientation و یک موقعیت بهواحد نقطه، IDrawingGuidesCollection.add را فراخوانی کنید.
مثال زیر یک راهنمای عمودی را در سمت راست مرکز اسلاید و یک راهنمای افقی را در زیر آن اضافه میکند:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide_size = presentation.slide_size.size
guides = presentation.view_properties.slide_view_properties.drawing_guides
guides.add(slides.Orientation.VERTICAL, slide_size.width / 2 + 12.5)
guides.add(slides.Orientation.HORIZONTAL, slide_size.height / 2 + 12.5)
presentation.save("drawing-guides.pptx", slides.export.SaveFormat.PPTX)
دسترسی به راهنماهای رسم
ویژگی IDrawingGuidesCollection.count و ایندکسگر آن دسترسی به راهنماهای موجود را فراهم میکنند. ویژگیهای IDrawingGuide.orientation، IDrawingGuide.position، و IDrawingGuide.color میتوانند خوانده یا تغییر یابند.
مثال زیر راهنماهای نمای اسلاید را از ارائهای که در بالا ایجاد شد، میخواند:
import aspose.slides as slides
with slides.Presentation("drawing-guides.pptx") as presentation:
guides = presentation.view_properties.slide_view_properties.drawing_guides
for index in range(guides.count):
guide = guides[index]
print(f"Guide {index}: orientation = {guide.orientation}, position = {guide.position}, color = {guide.color}")
افزودن راهنماها به اسلایدهای مستر و طرحبندی
یک اسلاید مستر و هر یک از اسلایدهای طرحبندی آن میتوانند مجموعههای راهنمای رسم خود را داشته باشند. برای یک اسلاید مستر از IMasterSlide.drawing_guides و برای یک اسلاید طرحبندی از ILayoutSlide.drawing_guides استفاده کنید.
مثال زیر یک راهنمای عمودی را به اولین اسلاید مستر و یک راهنمای افقی را به اولین اسلاید طرحبندی اضافه میکند:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide_size = presentation.slide_size.size
master_guides = presentation.masters[0].drawing_guides
layout_guides = presentation.layout_slides[0].drawing_guides
master_guides.add(slides.Orientation.VERTICAL, slide_size.width / 2 - 20)
layout_guides.add(slides.Orientation.HORIZONTAL, slide_size.height / 2 + 20)
presentation.save("master-layout-drawing-guides.pptx", slides.export.SaveFormat.PPTX)
افزودن راهنماها به مسترهای یادداشت و جزوه
مسترهای یادداشت و مسترهای جزوه نیز از راهنماهای رسم پشتیبانی میکنند. برای دسترسی به مجموعههای آنها از IMasterNotesSlide.drawing_guides و IMasterHandoutSlide.drawing_guides استفاده کنید. اگر ارائه حاوی یکی از این مسترها نباشد، IMasterNotesSlideManager.set_default_master_notes_slide یا IMasterHandoutSlideManager.set_default_master_handout_slide مستر پیشفرض را ایجاد کرده و برمیگرداند.
مثال زیر یک راهنمای افقی را به یک مستر یادداشت و یک راهنمای عمودی را به یک مستر جزوه اضافه میکند:
import aspose.slides as slides
with slides.Presentation() as presentation:
notes_size = presentation.notes_size.size
notes_master = presentation.master_notes_slide_manager.set_default_master_notes_slide()
handout_master = presentation.master_handout_slide_manager.set_default_master_handout_slide()
notes_master.drawing_guides.add(slides.Orientation.HORIZONTAL, notes_size.height / 2 + 50)
handout_master.drawing_guides.add(slides.Orientation.VERTICAL, notes_size.width / 2 - 50)
presentation.save("notes-handout-drawing-guides.pptx", slides.export.SaveFormat.PPTX)
پاکسازی راهنماهای رسم
با فراخوانی IDrawingGuidesCollection.clear میتوانید تمام راهنماها را از یک مجموعه خاص حذف کنید. پاکسازی یک مجموعه بر راهنماهای ذخیرهشده در حوزه دیگر تأثیر نمیگذارد.
مثال زیر راهنماهای نمای اسلاید و تمام راهنماهای موجود بر اسلایدهای مستر، اسلایدهای طرحبندی، مستر یادداشت و مستر جزوه را بدون ایجاد مسترهای گمشده پاک میکند:
import aspose.slides as slides
with slides.Presentation("presentation-with-guides.pptx") as presentation:
presentation.view_properties.slide_view_properties.drawing_guides.clear()
for master_slide in presentation.masters:
master_slide.drawing_guides.clear()
for layout_slide in presentation.layout_slides:
layout_slide.drawing_guides.clear()
notes_master = presentation.master_notes_slide_manager.master_notes_slide
if notes_master is not None:
notes_master.drawing_guides.clear()
handout_master = presentation.master_handout_slide_manager.master_handout_slide
if handout_master is not None:
handout_master.drawing_guides.clear()
presentation.save("presentation-without-guides.pptx", slides.export.SaveFormat.PPTX)
سوالات متداول
آیا راهنماهای رسم در نمایش اسلاید یا تصاویر صادرشده ظاهر میشوند؟
خیر. راهنماهای رسم ابزارهای همراستایی برای ویرایش هستند و بهعنوان محتوای ارائه رندر نمیشوند.
آیا میتوان یک راهنمای رسم را مستقیم به یک اسلاید عادی افزود؟
راهنماهای ویرایشی اسلاید عادی در ویژگیهای نمای اسلاید ارائه ذخیره میشوند. مجموعههای راهنمای جداگانهای برای اسلایدهای مستر، اسلایدهای طرحبندی، مسترهای یادداشت و مسترهای جزوه موجود است.
کدام واحدها برای موقعیت راهنماها استفاده میشود؟
موقعیتها بر حسب نقطه تعیین میشوند که ۷۲ نقطه برابر با یک اینچ است. موقعیتهای عمودی از لبهٔ چپ اندازهگیری میشوند و موقعیتهای افقی از لبهٔ بالا.
آیا پاکسازی راهنماهای رسم شکلها را حذف یا محتوای اسلاید را تغییر میدهد؟
خیر. متد clear تنها راهنماهای موجود در مجموعهٔ انتخابشده را حذف میکند. شکلها و سایر محتوای اسلاید بیتغییری میمانند.