دریافت و به‌روزرسانی ویژگی‌های نمای ارائه در پایتون از طریق جاوا

معرفی

در نمای عادی PowerPoint، اسلاید بین پانل کناری برای بندهای کوچک یا طرح کلی و پانل یادداشت‌ها در پایین نمایش داده می‌شود. Aspose.Slides برای Python از طریق Java ترجیحات ذخیره‌شدهٔ ویرایش ارائه را از طریق Presentation.getViewProperties آشکار می‌کند. این‌ها شامل چیدمان پانل‌ها، سطوح زوم، فاصله‌بندی شبکه و قابلیت نمایش نظرات هستند.

درباره NormalViewProperties

از getNormalViewProperties برای دسترسی به کلاس NormalViewProperties استفاده کنید. setShowOutlineIcons تعیین می‌کند آیا نمادها در کنار عناوین اسلاید در طرح کلی نمایش داده شوند یا نه. setSnapVerticalSplitter اجازه می‌دهد پانل کناری هنگام باریک شدن توسط کاربر به حالت کوچک شده خود بپیچد. setPreferSingleView نشان‌دهندهٔ تمایل به نمایش یک پانل در تمام پنجره است.

setVerticalBarState تقسیم‌کننده بین پانل کناری و اسلاید را کنترل می‌کند. setHorizontalBarState تقسیم‌کننده بالای پانل یادداشت‌ها را تنظیم می‌کند. هر دو مقدار از نوع SplitterBarStateType با گزینه‌های Minimized، Maximized یا Restored می‌پذیرند.

درباره بازگرداندن NormalViewProperties

زمانی که یک تقسیم‌کننده بازگردانی می‌شود، getRestoredLeft اندازهٔ ذخیره‌شدهٔ پانل کناری و getRestoredTop اندازهٔ ذخیره‌شدهٔ ناحیهٔ بالایی اسلاید را برمی‌گرداند. هر دو یک نمونه از NormalViewRestoredProperties باز می‌گردانند. متد setDimensionSize درصدی بین ۰ تا ۱۰۰ می‌پذیرد و setAutoAdjust تعیین می‌کند آیا ویرایشگر هنگام تغییر اندازهٔ پنجره اندازه را تنظیم کند یا نه.

این مثال یک ارائه موجود را به‌روزرسانی می‌کند. تقسیم‌کنندهٔ افقی را بازگردانی می‌کند، اندازهٔ بازگردانده‌شدهٔ توسط getRestoredTop را به ۸۰٪ تنظیم می‌کند و تنظیم خودکار را فعال می‌سازد، و تقسیم‌کنندهٔ عمودی را به حالت حداکثر می‌رساند. همچنین setShowOutlineIcons را فراخوانی می‌کند تا نمادها در نمای طرح کلی نمایش داده شوند.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SplitterBarStateType

presentation = Presentation("demo.pptx")
try:
    normal_view_properties = presentation.getViewProperties().getNormalViewProperties()
    normal_view_properties.setHorizontalBarState(SplitterBarStateType.Restored)
    normal_view_properties.setVerticalBarState(SplitterBarStateType.Maximized)

    normal_view_properties.getRestoredTop().setAutoAdjust(True)
    normal_view_properties.getRestoredTop().setDimensionSize(80)
    normal_view_properties.setShowOutlineIcons(True)

    presentation.save("presentation_normal_view_state.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تنظیم مقدار پیش‌فرض زوم

getSlideViewProperties و getNotesViewProperties تنظیمات زوم مستقلی برای ویرایشگر ذخیره می‌کنند. این تنظیمات بر ابعاد اسلاید، پخش اسلایدشو یا وضوح صادرات تصویر تأثیر نمی‌گذارند.

این مثال یک ارائه موجود را باز می‌کند و با فراخوانی setVariableScale اسلاید را با پنجرهٔ ویرایش هم‌ اندازه می‌کند. برای صفحهٔ یادداشت‌ها، مقیاس خودکار را غیرفعال می‌کند و با فراخوانی setScale زوم ثابت ۸۰٪ را تنظیم می‌کند.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    view_properties = presentation.getViewProperties()
    view_properties.getSlideViewProperties().setVariableScale(True)
    notes_view = view_properties.getNotesViewProperties()
    notes_view.setVariableScale(False)
    notes_view.setScale(80)

    presentation.save("zoom.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تنظیم فاصله‌بندی شبکه

setGridSpacing فاصله بین خطوط شبکهٔ ویرایشی را در کل ارائه تنظیم می‌کند. مقدار مثبت بر حسب نقطه دریافت می‌کند که هر اینچ ۷۲ نقطه دارد. این مثال فاصلهٔ جاری را در یک ارائه موجود چاپ می‌کند و با تنظیم فواصل به ۱۸ نقطه، شبکه‌ای به اندازهٔ یک‌چهارم اینچ ذخیره می‌کند.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    grid_spacing = presentation.getViewProperties().getGridSpacing()
    print(f"Current grid spacing: {grid_spacing} points")

    presentation.getViewProperties().setGridSpacing(18.0)

    presentation.save("grid-spacing.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

شبکه با فاصلهٔ ثابتی تکرار می‌شود. Drawing guides موقعیت‌های افقی یا عمودی فردی را علامت‌گذاری می‌کنند. هر دو ابزار کمکی برای ویرایش هستند و فقط در ویرایشگرهایی که آنها را نشان می‌دهند ظاهر می‌شوند. نمایش اسلایدها و صادرات به PDF، تصاویر یا SVG آنها را حذف می‌کند.

نمایش یا عدم نمایش نظرات هنگام باز کردن ارائه

setShowComments ترجیحی را ذخیره می‌کند که ویرایشگرهای سازگار هنگام باز کردن ارائه از آن استفاده می‌کنند. برای یک ارائه موجود با نظرات، این مثال تنظیم فعلی را چاپ می‌کند و یک نسخهٔ کپی با نظرات مخفی ذخیره می‌کند. همچنین با فراخوانی setLastView همراه با ViewType.SlideView باعث می‌شود نسخهٔ کپی در نمای اسلاید باز شود.

import jpype
import asposeslides

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

from asposeslides.api import NullableBool, Presentation, SaveFormat, ViewType

presentation = Presentation("comments.pptx")
try:
    show_comments = presentation.getViewProperties().getShowComments()
    print(f"Current comment visibility: {show_comments}")

    presentation.getViewProperties().setShowComments(NullableBool.False_)
    presentation.getViewProperties().setLastView(ViewType.SlideView)
    
    presentation.save("comments-hidden.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

پنهان کردن نظرات متن، نویسندگان، موقعیت‌ها، پاسخ‌ها و وضعیت‌های آنها را حفظ می‌کند. برای تغییر خود نظرات، به Presentation Comments مراجعه کنید. تنظیمات صادرات تعیین می‌کند آیا نظرات در PDF، HTML، تصاویر، یادداشت‌ها یا برگه‌های تک‌صفحه ظاهر شوند یا نه.

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

چرا شبکه هنگام بازگشایی دوبارهٔ ارائه مخفی می‌شود؟

ارائه فاصلهٔ شبکه را ذخیره می‌کند. برای مشاهدهٔ شبکه، قابلیت نمایش شبکه را در ویرایشگر فعال کنید.

آیا حذف راهنمای رسم تغییر فاصلهٔ شبکه را ایجاد می‌کند؟

خیر. افزودن، جابه‌جا یا حذف یک راهنما، فاصلهٔ شبکه را تغییری نمی‌دهد.

آیا می‌توان تنظیمات نمای متفاوت برای بخش‌های مختلف ارائه داشت؟

خیر. Presentation.getViewProperties برای کل ارائه اعمال می‌شود.

آیا می‌توان تنظیمات نمای متفاوتی برای کاربران مختلف ذخیره کرد؟

فایل یک مجموعهٔ تنظیمات نمای برای همه ذخیره می‌کند. یک ویرایشگر ممکن است ترجیحات محلی کاربر را نیز اعمال کند.

آیا می‌توان تنظیمات نمای را در قالب ذخیره کرد؟

بله. ارائه‌های ساخته‌شده از قالب، تنظیمات نمای ذخیره‌شدهٔ آن قالب را به ارث می‌برند.