مدیریت سرصفحهها و پانویسهای ارائه در پایتون از طریق جاوا
نمای کلی
PowerPoint برای انواع صفحههای مختلف از نگهدارندههای متفاوت سرصفحه و پانویس استفاده میکند. Aspose.Slides برای Python از طریق Java به شما امکان میدهد متن و قابلیت نمایش این نگهدارندهها را از طریق کلاسهای مدیریت سرصفحه/پانویس کنترل کنید.
در دسترس بودن نگهدارندهها بستگی به محدوده دارد:
| محدوده | سرصفحه | پانویس | تاریخ/زمان | شماره اسلاید/صفحه |
|---|---|---|---|---|
| اسلاید عادی | خیر | بله | بله | بله |
| مستر یادداشت | بله | بله | بله | بله |
| اسلاید یادداشت | بله | بله | بله | بله |
| مستر جزوه | بله | بله | بله | بله |
یک اسلاید نمایش عادی هیچ نگهدارنده سرصفحهای ندارد. سرصفحهها در صفحات یادداشت و جزوهها موجود هستند. برای اسلایدهای عادی، به جای سرصفحه از نگهدارندههای پانویس، تاریخ/زمان و شماره اسلاید استفاده کنید.
محدودهی تغییری که اعمال میکنید به مدیری که استفاده میکنید بستگی دارد. کلاس SlideHeaderFooterManager یک اسلاید عادی را کنترل میکند. کلاس NotesSlideHeaderFooterManager یک اسلاید یادداشت را کنترل میکند. مدیران مستر و چیدمان نیز میتوانند تنظیمات را به اسلایدهای وابسته منتقل کنند، در حالی که کلاس MasterHandoutSlideHeaderFooterManager مستر جزوه را کنترل میکند.
تنظیم پانویس، تاریخ/زمان و شماره اسلایدها در اسلایدهای عادی
برای اسلایدهای عادی، فرآیند پایه این است که به مدیر سرصفحه/پانویس هر اسلاید دسترسی پیدا کنید، متن پانویس و تاریخ/زمان را تنظیم کنید، نگهدارندههای مورد نیاز را فعال کنید و ارائه را ذخیره کنید. شماره اسلایدها توسط ارائه تولید میشوند، بنابراین فقط نیاز به کنترل نمایش آنها دارید.
از setFooterText و setDateTimeText برای تنظیم متن استفاده کنید و از setFooterVisibility، setDateTimeVisibility و setSlideNumberVisibility برای نمایش نگهدارندههای مربوطه استفاده کنید.
مثال زیر بهصورت سراسری پانویس، متن تاریخ/زمان و نمایش شماره اسلاید را برای تمام اسلایدهای عادی اعمال میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
for slide in presentation.getSlides():
header_footer_manager = slide.getHeaderFooterManager()
header_footer_manager.setFooterText("Company Confidential")
header_footer_manager.setFooterVisibility(True)
header_footer_manager.setDateTimeText("Date and time text")
header_footer_manager.setDateTimeVisibility(True)
header_footer_manager.setSlideNumberVisibility(True)
presentation.save("presentation_with_slide_footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
اگر فقط نیاز به بهروزرسانی یک اسلاید دارید، به جای پیمایش کل مجموعه از متد getSlides برای دسترسی مستقیم به آن اسلاید استفاده کنید.
تنظیم سرصفحه و پانویس در مستر یادداشت
مستر یادداشت قالببندی عمومی و رفتار نگهدارندهها را برای صفحات یادداشت تعریف میکند. زمانی که میخواهید فقط مستر یادداشت را تغییر دهید، از کلاس MasterNotesSlideHeaderFooterManager استفاده کنید.
مثال زیر سرصفحه، پانویس و متن تاریخ/زمان را روی مستر یادداشت تنظیم میکند و تمام نگهدارندههای پشتیبانیشده را در آن مستر قابل مشاهده میسازد:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()
if master_notes_slide is not None:
header_footer_manager = master_notes_slide.getHeaderFooterManager()
header_footer_manager.setHeaderText("Notes header")
header_footer_manager.setHeaderVisibility(True)
header_footer_manager.setFooterText("Notes footer")
header_footer_manager.setFooterVisibility(True)
header_footer_manager.setDateTimeText("Date and time text")
header_footer_manager.setDateTimeVisibility(True)
header_footer_manager.setSlideNumberVisibility(True)
presentation.save("presentation_with_notes_master_footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
متد getMasterNotesSlide زمانی که ارائه شامل مستر یادداشت نباشد، مقدار None برمیگرداند.
اعمال تنظیمات مستر یادداشت روی اسلایدهای فرزند یادداشت
یک مستر یادداشت میتواند تنظیمات سرصفحه و پانویس را هم برای خود و هم برای تمام اسلایدهای یادداشت وابسته اعمال کند. وقتی همان تنظیمات باید در کل سلسلهمراتب یادداشتها اعمال شوند، از متدهای انتشار اختصاصی در MasterNotesSlideHeaderFooterManager استفاده کنید.
به عنوان مثال، متدهای setHeaderAndChildHeadersText و setHeaderAndChildHeadersVisibility سرصفحه مستر یادداشت و تمام سرصفحههای فرزند را بهروزرسانی میکنند. متدهای معادل برای پانویس، تاریخ/زمان و شماره اسلاید نیز موجود هستند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()
if master_notes_slide is not None:
header_footer_manager = master_notes_slide.getHeaderFooterManager()
header_footer_manager.setHeaderAndChildHeadersText("Notes header")
header_footer_manager.setHeaderAndChildHeadersVisibility(True)
header_footer_manager.setFooterAndChildFootersText("Notes footer")
header_footer_manager.setFooterAndChildFootersVisibility(True)
header_footer_manager.setDateTimeAndChildDateTimesText("Date and time text")
header_footer_manager.setDateTimeAndChildDateTimesVisibility(True)
header_footer_manager.setSlideNumberAndChildSlideNumbersVisibility(True)
presentation.save("presentation_with_child_notes_footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
متدهای انتشار استفادهشده در بالا عبارتند از setFooterAndChildFootersText، setFooterAndChildFootersVisibility، setDateTimeAndChildDateTimesText، setDateTimeAndChildDateTimesVisibility و setSlideNumberAndChildSlideNumbersVisibility.
تنظیم سرصفحه و پانویس در یک اسلاید یادداشت اختصاصی
یک اسلاید یادداشت به یک اسلاید عادی خاص تعلق دارد. وقتی میخواهید فقط همان صفحه یادداشت را سفارشی کنید، از کلاس NotesSlideHeaderFooterManager استفاده کنید.
متد addNotesSlide اسلاید یادداشت مربوط به اسلاید فعلی را بازمیگرداند و در صورت عدم وجود، یکی ایجاد میکند. مثال زیر صفحه یادداشت مرتبط با اولین اسلاید ارائه را پیکربندی میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide = presentation.getSlides().get_Item(0)
notes_slide = slide.getNotesSlideManager().addNotesSlide()
header_footer_manager = notes_slide.getHeaderFooterManager()
header_footer_manager.setHeaderText("Header for the first notes page")
header_footer_manager.setHeaderVisibility(True)
header_footer_manager.setFooterText("Footer for the first notes page")
header_footer_manager.setFooterVisibility(True)
header_footer_manager.setDateTimeText("Date and time text")
header_footer_manager.setDateTimeVisibility(True)
header_footer_manager.setSlideNumberVisibility(True)
presentation.save("presentation_with_custom_notes_footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
اگر ابتدا تنظیمات را از مستر یادداشت انتشار دهید و سپس یک اسلاید یادداشت منفرد را تغییر دهید، تنظیمات بعدی برای هر اسلاید امکان سفارشیسازی مستقل آن صفحه یادداشت را میدهد.
تنظیم سرصفحه و پانویس در مستر جزوه
صفحات جزوه از مستر جزوه برای نگهدارندههای سرصفحه، پانویس، تاریخ/زمان و شماره صفحه استفاده میکنند. برخلاف صفحات یادداشت، تنظیمات جزوه از طریق مستر جزوه مدیریت میشوند و نه از طریق اسلایدهای جزوهٔ تکتک.
از متد getMasterHandoutSlide برای دسترسی به مستر جزوه استفاده کنید. اگر موجود نباشد، با فراخوانی setDefaultMasterHandoutSlide مستر جزوهٔ پیشفرض را ایجاد کنید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
master_handout_slide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide()
if master_handout_slide is None:
master_handout_slide = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide()
if master_handout_slide is not None:
header_footer_manager = master_handout_slide.getHeaderFooterManager()
header_footer_manager.setHeaderText("Handout header")
header_footer_manager.setHeaderVisibility(True)
header_footer_manager.setFooterText("Handout footer")
header_footer_manager.setFooterVisibility(True)
header_footer_manager.setDateTimeText("Date and time text")
header_footer_manager.setDateTimeVisibility(True)
header_footer_manager.setSlideNumberVisibility(True)
presentation.save("presentation_with_handout_footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
درک محدوده و ارثبری
مدیر سرصفحه/پانویسی را انتخاب کنید که با محدودهای که میخواهید تغییر دهید مطابقت داشته باشد:
- SlideHeaderFooterManager تنظیمات پانویس، تاریخ/زمان و شماره اسلاید را برای یک اسلاید عادی تغییر میدهد.
- LayoutSlideHeaderFooterManager یک اسلاید چیدمان را کنترل میکند و میتواند تنظیمات پشتیبانیشده را به اسلایدهای وابسته منتشر کند.
- MasterSlideHeaderFooterManager یک مستر اسلاید عادی را کنترل میکند و میتواند تنظیمات پشتیبانیشده را به اسلایدهای وابسته منتشر کند.
- MasterNotesSlideHeaderFooterManager مستر یادداشت را کنترل میکند و میتواند تنظیمات را به تمام اسلایدهای یادداشت وابسته منتشر کند.
- NotesSlideHeaderFooterManager یک اسلاید یادداشت را تغییر میدهد و علاوه بر پانویس، تاریخ/زمان و شماره اسلاید، یک نگهدارنده سرصفحه نیز پشتیبانی میکند.
- MasterHandoutSlideHeaderFooterManager مستر جزوه را تغییر میدهد و از چهار نوع نگهدارنده پشتیبانی میکند.
از انتشار از یک مستر یا چیدمان زمانی استفاده کنید که همان تنظیم باید در تمام سطوح سلسلهمراتبی آن اعمال شود. وقتی نیاز به تنظیم محلی برای یک صفحه دارید، از مدیر اسلاید منفرد یا اسلاید‑یادداشت استفاده کنید.
سوالات متداول
آیا میتوانم سرصفحهای به یک اسلاید عادی اضافه کنم؟
خیر. PowerPoint برای اسلایدهای عادی نگهدارنده سرصفحه تعریف نمیکند. در اسلایدهای عادی از نگهدارندههای پانویس، تاریخ/زمان و شماره اسلاید استفاده کنید. نگهدارندههای سرصفحه در صفحات یادداشت و جزوهها موجود هستند.
اگر یک نگهدارنده پانویس، تاریخ/زمان یا شماره اسلاید قابل مشاهده نباشد چه کار کنم؟
از مدیر سرصفحه/پانویس مربوطه استفاده کنید تا قابلیت نمایش آن را بررسی و در صورت نیاز فعال کنید. به عنوان مثال، متد isFooterVisible نشان میدهد آیا نگهدارنده پانویس وجود دارد یا خیر و setFooterVisibility قابلیت نمایش آن را تغییر میدهد.
چگونه میتوانم شمارهگذاری اسلایدها را از مقداری غیر از 1 آغاز کنم؟
متد setFirstSlideNumber ارائه را فراخوانی کنید. پس از آن نگهدارندههای شماره اسلاید از دنبالهٔ شمارهگذاری بهروز شده استفاده میکنند.
وقتی به PDF، تصویر یا HTML صادر میشود، سرصفحه و پانویس چه اتفاقی میافتند؟
عناصر قابل مشاهدهٔ سرصفحه و پانویس همراه با بقیه محتوای ارائه در قالب خروجی رندر میشوند. ظاهر آنها بستگی به نوع صفحهای دارد که صادر میشود و تنظیمات قابل مشاهدهٔ نگهدارندههای مربوطه.