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

مقدمه

نمای عادی شامل سه ناحیه محتوا است: خود اسلاید، یک ناحیه محتوا کناری، و یک ناحیه محتوا پایینی. ویژگی‌های مربوط به موقعیت‌گذاری نواحی مختلف محتوا. این اطلاعات به برنامه امکان می‌دهد وضعیت نمای خود را در فایل ذخیره کند، به طوری که هنگام باز شدن مجدد، نمای همان وضعیت را داشته باشد که در آخرین ذخیره‌سازی ارائه بوده است.

متد ViewProperties.getNormalViewProperties اضافه شده است تا دسترسی به ویژگی‌های نمای عادی ارائه را فراهم کند.

کلاس‌های NormalViewProperties, NormalViewRestoredProperties و انواع مشتق‌شدهٔ آن، همچنین شمارش‌گر SplitterBarStateType اضافه شده‌اند.

دربارهٔ NormalViewProperties

نمایانگر ویژگی‌های نمای عادی است.

متدهای getShowOutlineIcons و setShowOutlineIcons مشخص می‌کنند که آیا برنامه باید در صورت نمایش محتوای طرح کلی در هر یک از نواحی محتوا در حالت نمای عادی، آیکون‌ها را نشان دهد یا خیر.

متدهای getSnapVerticalSplitter و setSnapVerticalSplitter مشخص می‌کنند که آیا تقسیم‌کنندهٔ عمودی باید هنگام کوچک شدن کافی ناحیهٔ کناری به حالت کمینه بچسبد یا خیر.

ویژگی‌های getPreferSingleView و setPreferSingleView مشخص می‌کنند که آیا کاربر ترجیح می‌دهد یک ناحیهٔ تک‑محتوا در تمام پنجره به جای نمای عادی استاندارد با سه ناحیه محتوا ببیند. در صورت فعال‌سازی، برنامه ممکن است یکی از نواحی محتوا را در تمام پنجره نمایش دهد.

متدهای getVerticalBarState و getHorizontalBarState وضعیت نوار تقسیم‌کنندهٔ عمودی یا افقی را که باید نمایش داده شود، تعیین می‌کنند. نوار تقسیم‌کنندهٔ افقی اسلاید را از ناحیهٔ محتوا زیر اسلاید جدا می‌کند، نوار تقسیم‌کنندهٔ عمودی اسلاید را از ناحیهٔ محتوا کناری جدا می‌کند. مقادیر ممکن عبارتند از: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized و SplitterBarStateType.Restored.

متدهای getRestoredLeft و getRestoredTop اندازه‌گیری ناحیهٔ بالایی یا کناری اسلاید در نمای عادی را زمانی که مقدار SplitterBarStateType.Restored برای getVerticalBarState و getHorizontalBarState اعمال شده، مشخص می‌کند.

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

ابعاد ناحیهٔ اسلاید (عرض زمانی که فرزند getRestoredTop باشد، ارتفاع زمانی که فرزند getRestoredLeft باشد) در نمای عادی را زمانی که ناحیه دارای اندازهٔ بازنشانی متغیر (نه کمینه و نه بیشینه) باشد، مشخص می‌کند.

متد getDimensionSize اندازهٔ ناحیهٔ اسلاید (عرض زمانیکه فرزند restoredTop باشد، ارتفاع زمانیکه فرزند restoredLeft باشد) را تعیین می‌کند.

متد getAutoAdjust مشخص می‌کند که آیا اندازهٔ ناحیهٔ محتوا کناری باید برای اندازهٔ جدید جبران کند وقتی که پنجرهٔ حاوی نما در برنامه تغییر اندازه می‌دهد.

در مثال زیر نشان داده شده است که چگونه می‌توانید به ویژگی‌های ViewProperties.getNormalViewProperties برای یک ارائه دسترسی پیدا کنید.


var pres = new aspose.slides.Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(aspose.slides.SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(aspose.slides.SplitterBarStateType.Maximized);

    // بازگرداندن ویژگی‌های نمای ارائه
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
    pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);
    pres.save("presentation_normal_view_state.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

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

برای تنظیم ویژگی‌های نما، لطفاً مراحل زیر را دنبال کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. View Properties مربوط به Presentation را تنظیم کنید.
  3. ارائه را به عنوان فایل PPTX بنویسید. در مثال زیر، مقدار بزرگ‌نمایی برای نمای اسلاید و نمای یادداشت‌ها تنظیم شده است.
var presentation = new aspose.slides.Presentation();
try {
    // تنظیم ویژگی‌های نمای ارائه
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // مقدار بزرگ‌نمایی به درصد برای نمای اسلاید
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // مقدار بزرگ‌نمایی به درصد برای نمای یادداشت‌ها
    presentation.save("Zoom_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

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

تنظیمات View settings در سطح ارائه تعریف می‌شوند (Normal View/Slide View)، نه به‌صورت بخش به بخش، بنابراین یک مجموعه پارامتر برای تمام سند هنگام باز شدن اعمال می‌شود.

آیا می‌توانم وضعیت‌های نما متفاوتی برای کاربران مختلف از پیش تعریف کنم؟

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

آیا می‌توانم قالبی با ویژگی‌های نمای از پیش تعریف‌شده آماده کنم تا ارائه‌های جدید به همان شکل باز شوند؟

بله. زیرا view properties در سطح ارائه ذخیره می‌شوند، می‌توانید آن‌ها را در قالبی قرار دهید و اسناد جدید را از آن با همان پیکربندی اولیه نما ایجاد کنید.

مدیریت ویژگی‌های ارائه در JavaScript مدیریت نظرات ارائه در JavaScript