مدیریت اسلاید مسترهای ارائه در جاوا

نمای کلی

یک slide master تنظیمات طراحی مشترک برای یک گروه از اسلایدها را تعریف می‌کند. می‌تواند شامل اشکال عمومی، لوگوها, پس‌زمینه‌ها, سبک‌های متنی, تنظیمات تم و تنظیمات پاورقی باشد. در PowerPoint، ویرایش یک slide master معمولاً روشی برای حفظ ثبات یک ارائه بدون تکرار همان قالب‌بندی در هر اسلاید است.

Aspose.Slides for Java همان مدل را پشتیبانی می‌کند. یک ارائه می‌تواند یک یا چند اسلاید master داشته باشد و هر اسلاید master می‌تواند چندین اسلاید layout را شامل شود. اسلایدهای عادی معمولاً به‌طور مستقیم به اسلاید master ارجاع نمی‌دهند. در عوض، یک اسلاید عادی از یک اسلاید layout استفاده می‌کند و آن اسلاید layout به یک اسلاید master تعلق دارد.

سلسله‌مراتب به شرح زیر است:

Slide master – طراحی مشترک و تم را تعریف می‌کند.
Layout slide – یک ترتیب خاص از مکان‌گیرها و قالب‌بندی در سطح طرح را تعریف می‌کند.
Normal slide – شامل محتوای واقعی ارائه است و از یک layout slide استفاده می‌کند.

سلسله‌مراتب اسلایدهای master، اسلایدهای layout و اسلایدهای normal

در Aspose.Slides، یک اسلاید master توسط رابط IMasterSlide نشان داده می‌شود. تمام اسلایدهای master در یک ارائه از طریق مجموعه Presentation.getMasters در دسترس هستند که پیاده‌سازی IMasterSlideCollection را دارد.

ارث‌بری

زمانی که یک ویژگی در بیش از یک سطح تعریف شده باشد، سطح خاص‌تر برتری دارد. به عنوان مثال، اگر یک اسلاید master و یک اسلاید layout هر دو پس‌زمینه‌ای تعریف کنند، اسلایدهای مبتنی بر آن layout از پس‌زمینه layout استفاده می‌کنند. برای اطلاعات بیشتر درباره اسلایدهای layout، به Apply or Change Slide Layouts مراجعه کنید.

دسترسی به Slide Masterها

در PowerPoint می‌توانید نمای Slide Master را از View > Slide Master باز کنید.

دستور Slide Master در برگه View برنامه PowerPoint

در Aspose.Slides از مجموعه getMasters() برای دسترسی به اسلایدهای master استفاده کنید:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide firstMasterSlide = presentation.getMasters().get_Item(0);
    int masterSlideCount = presentation.getMasters().size();
    int firstMasterLayoutSlideCount = firstMasterSlide.getLayoutSlides().size();

    System.out.println("Master slides: " + masterSlideCount);
    System.out.println("Layouts in the first master: " + firstMasterLayoutSlideCount);
} finally {
    presentation.dispose();
}

همچنین می‌توانید اسلاید master استفاده‌شده توسط یک اسلاید عادی را از طریق layout آن دریافت کنید:

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ILayoutSlide layoutSlide = slide.getLayoutSlide();
    IMasterSlide masterSlide = layoutSlide.getMasterSlide();
    String masterSlideName = masterSlide.getName();

    System.out.println(masterSlideName);
} finally {
    presentation.dispose();
}

محتویات یک Slide Master

یک اسلاید master یک شیء شبیه اسلاید است. این شیء رابط IBaseSlide را پیاده‌سازی می‌کند، بنابراین بسیاری از ویژگی‌های اسلاید که برای اسلایدهای عادی و layout استفاده می‌شود را در اختیار می‌گذارد. اعضای اختصاصی master در صفحه API IMasterSlide فهرست شده‌اند.

عضوهای معمولاً استفاده‌شده master عبارتند از:

عضو	هدف
`getBackground()`	پس‌زمینه اسلاید در سطح master را تنظیم می‌کند.
`getShapes()`	اشکالی که بر روی master قرار گرفته‌اند، مانند لوگوها، قاب‌های تصویر و متن مشترک، را ذخیره می‌کند.
`getLayoutSlides()`	اسلایدهای layout متعلق به master را ذخیره می‌کند.
`getThemeManager()`	دسترسی به APIهای تم master را فراهم می‌کند.
`getHeaderFooterManager()`	سرصفحه‌ها، پاورقی‌ها، تاریخ‌ها و شماره اسلایدها را برای master و layoutهای فرزند آن کنترل می‌کند.
`getDependingSlides()`	اسلایدهای normalی که از طریق layoutهای خود به master وابسته هستند را بر می‌گرداند.

افزودن تصویر به یک Slide Master

زمانی که تصویری را به یک اسلاید master اضافه کنید، بر روی اسلایدهایی که از layoutهای آن master استفاده می‌کنند ظاهر می‌شود. این برای لوگوها، واترمارک‌ها، نوارهای تزئینی و سایر عناصر بصری تکراری مفید است.

مثال زیر یک لوگو را به اولین اسلاید master اضافه می‌کند:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    IImage logo = Images.fromFile("logo.png");

    try {
        IPPImage logoImage = presentation.getImages().addImage(logo);

        masterSlide.getShapes().addPictureFrame(
                ShapeType.Rectangle,
                20,
                20,
                80,
                80,
                logoImage);
    } finally {
        logo.dispose();
    }

    presentation.save("presentation-with-logo.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

برای اطلاعات بیشتر درباره قاب‌های تصویر، به Picture Frame مراجعه کنید.

کار با Placeholders

Placeholders معمولاً در اسلایدهای layout تعریف می‌شوند. اسلاید master سبک و تم مشترکی را فراهم می‌کند که این layoutها ارث‌بری می‌کنند، در حالی که هر layout تصمیم می‌گیرد کدام placeholders موجود باشد و در کجا قرار گیرند.

در PowerPoint دستورات placeholder در نمای Slide Master در دسترس هستند.

دستور Insert Placeholder در نمای Slide Master برنامه PowerPoint

برای افزودن placeholders جدید با Aspose.Slides، با اسلاید layout که به master تعلق دارد کار کنید:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    ILayoutSlide blankLayoutSlide = masterSlide.getLayoutSlides().getByType(SlideLayoutType.Blank);

    if (blankLayoutSlide == null) {
        blankLayoutSlide = masterSlide.getLayoutSlides().add(SlideLayoutType.Blank, "Blank");
    }

    blankLayoutSlide.getPlaceholderManager().addTextPlaceholder(60, 120, 600, 80);

    presentation.getSlides().addEmptySlide(blankLayoutSlide);
    presentation.save("presentation-with-placeholder.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

همچنین می‌توانید اشکال placeholder که قبلاً بر روی یک اسلاید master وجود دارند را قالب‌بندی کنید. مثال زیر placeholder عنوان را پیدا کرده و یک پرکن خطی گرادیان اعمال می‌کند:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    IAutoShape titlePlaceholder = null;

    for (IShape shape : masterSlide.getShapes()) {
        if (shape instanceof IAutoShape) {
            IAutoShape autoShape = (IAutoShape) shape;

            if (autoShape.getPlaceholder() != null &&
                    autoShape.getPlaceholder().getType() == PlaceholderType.Title) {
                titlePlaceholder = autoShape;
                break;
            }
        }
    }

    if (titlePlaceholder != null) {
        Color redGradientColor = new Color(255, 0, 0);
        Color purpleGradientColor = new Color(128, 0, 128);

        titlePlaceholder.getFillFormat().setFillType(FillType.Gradient);
        titlePlaceholder.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear);
        titlePlaceholder.getFillFormat().getGradientFormat().getGradientStops().add(0.0f, redGradientColor);
        titlePlaceholder.getFillFormat().getGradientFormat().getGradientStops().add(255.0f, purpleGradientColor);
    }

    presentation.save("presentation-title-style.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

placeholder عنوان قالب‌بندی‌شده که توسط اسلایدهای عادی ارث‌بری می‌شود

برای گزینه‌های بیشتر درباره placeholders و قالب‌بندی متن، به Set Prompt Text in Placeholder و Text Formatting نگاه کنید.

تغییر پس‌زمینه یک Slide Master

پس‌زمینه master توسط layoutها و اسلایدهایی که آن را بازنویسی نمی‌کنند، به ارث می‌رسد. مثال زیر یک رنگ پس‌زمینه‌ی ثابت برای اولین اسلاید master تنظیم می‌کند:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    Color masterBackgroundColor = Color.GREEN;

    masterSlide.getBackground().setType(BackgroundType.OwnBackground);
    masterSlide.getBackground().getFillFormat().setFillType(FillType.Solid);
    masterSlide.getBackground().getFillFormat().getSolidFillColor().setColor(masterBackgroundColor);

    presentation.save("presentation-master-background.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

برای موضوعات مرتبط، به Presentation Background و Presentation Theme مراجعه کنید.

کپی کردن یک Slide Master به ارائه‌ای دیگر

از IMasterSlideCollection.addClone برای کپی کردن یک اسلاید master به ارائه‌ای دیگر استفاده کنید. master کپی‌شده سپس می‌تواند توسط layoutها و اسلایدهای مقصد استفاده شود.

Presentation sourcePresentation = new Presentation("source.pptx");
Presentation destinationPresentation = new Presentation("destination.pptx");
try {
    IMasterSlide sourceMasterSlide = sourcePresentation.getMasters().get_Item(0);
    IMasterSlide clonedMasterSlide = destinationPresentation.getMasters().addClone(sourceMasterSlide);

    destinationPresentation.save("destination-with-master.pptx", SaveFormat.Pptx);
} finally {
    sourcePresentation.dispose();
    destinationPresentation.dispose();
}

اگر نیاز به کپی کردن اسلایدهای عادی همراه با master آن‌ها دارید، به Clone Slides مراجعه کنید.

افزودن چندین Slide Master

یک ارائه می‌تواند شامل چندین اسلاید master باشد. این برای بخش‌های مختلفی که نیاز به برندینگ، ساختار صفحه یا تنظیمات تم متفاوتی دارند، مفید است.

دستورات PowerPoint برای وارد کردن و مدیریت اسلایدهای master

مثال زیر master پیش‌فرض را کپی می‌کند، به کپی پس‌زمینه‌ای متفاوت می‌دهد، یک layout تحت آن master کپی‌شده می‌سازد و یک اسلاید جدید بر پایه آن layout اضافه می‌کند:

Presentation presentation = new Presentation("presentation.pptx");
try {
    IMasterSlide defaultMasterSlide = presentation.getMasters().get_Item(0);
    IMasterSlide sectionMasterSlide = presentation.getMasters().addClone(defaultMasterSlide);
    Color sectionMasterBackgroundColor = Color.LIGHT_GRAY;

    sectionMasterSlide.getBackground().setType(BackgroundType.OwnBackground);
    sectionMasterSlide.getBackground().getFillFormat().setFillType(FillType.Solid);
    sectionMasterSlide.getBackground().getFillFormat().getSolidFillColor().setColor(sectionMasterBackgroundColor);

    ILayoutSlide sourceBlankLayout = defaultMasterSlide.getLayoutSlides().getByType(SlideLayoutType.Blank);
    if (sourceBlankLayout == null) {
        sourceBlankLayout = defaultMasterSlide.getLayoutSlides().get_Item(0);
    }

    ILayoutSlide sectionBlankLayout = sectionMasterSlide.getLayoutSlides().addClone(sourceBlankLayout);

    presentation.getSlides().addEmptySlide(sectionBlankLayout);
    presentation.save("presentation-with-multiple-masters.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

مقایسه Slide Masterها

اسلایدهای master می‌توانند با متد equals که از IBaseSlide ارث‌بری می‌شود مقایسه شوند. این مقایسه ساختار و محتوای ثابت مانند اشکال، متن، قالب‌بندی، انیمیشن‌ها و تنظیمات دیگر اسلاید را بررسی می‌کند. شناسه‌های منحصربه‌فرد مانند شناسه اسلاید یا مقادیر پویا مانند تاریخ جاری را مقایسه نمی‌کند.

Presentation firstPresentation = new Presentation("first.pptx");
Presentation secondPresentation = new Presentation("second.pptx");
try {
    int firstPresentationMasterCount = firstPresentation.getMasters().size();
    int secondPresentationMasterCount = secondPresentation.getMasters().size();

    for (int firstMasterIndex = 0; firstMasterIndex < firstPresentationMasterCount; firstMasterIndex++) {
        for (int secondMasterIndex = 0; secondMasterIndex < secondPresentationMasterCount; secondMasterIndex++) {
            IMasterSlide firstMasterSlide = firstPresentation.getMasters().get_Item(firstMasterIndex);
            IMasterSlide secondMasterSlide = secondPresentation.getMasters().get_Item(secondMasterIndex);
            boolean areMasterSlidesEqual = firstMasterSlide.equals(secondMasterSlide);

            if (areMasterSlidesEqual) {
                System.out.printf(
                        "first.pptx master #%d equals second.pptx master #%d%n",
                        firstMasterIndex,
                        secondMasterIndex);
            }
        }
    }
} finally {
    firstPresentation.dispose();
    secondPresentation.dispose();
}

برای اطلاعات بیشتر، به Compare Presentation Slides مراجعه کنید.

تنظیم نمای Slide Master به‌عنوان نمای پیش‌فرض

از متد setLastView در ViewProperties برای کنترل نمایی که PowerPoint ابتدا باز می‌کند استفاده کنید. مثال زیر ارائه را در نمای Slide Master باز می‌کند:

Presentation presentation = new Presentation("presentation.pptx");
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("presentation-master-view.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

برای تنظیمات بیشتر نمای، به Save Presentation نگاه کنید.

حذف اسلایدهای Master استفاده‌نشده

گاهی ارائه‌ها شامل اسلایدهای master می‌شوند که دیگر توسط هیچ اسلاید عادی استفاده نمی‌شوند. حذف masterهای استفاده‌نشده می‌تواند حجم فایل را کاهش داده و نگهداری قالب‌ها را ساده‌تر کند.

از removeUnused برای حذف masterهای استفاده‌نشده از مجموعه getMasters() استفاده کنید:

Presentation presentation = new Presentation("presentation.pptx");
try {
    presentation.getMasters().removeUnused(true);
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

همچنین می‌توانید از متد کم‌کد Compress.removeUnusedMasterSlides استفاده کنید:

Presentation presentation = new Presentation("presentation.pptx");
try {
    Compress.removeUnusedMasterSlides(presentation);
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

فرق بین slide master و layout slide چیست؟

یک slide master تنظیمات طراحی مشترک مانند تم، پس‌زمینه، اشکال عمومی و سبک‌های متنی را تعریف می‌کند. یک layout slide به یک اسلاید master تعلق دارد و چینش خاصی از مکان‌گیرها را تعریف می‌کند. یک اسلاید عادی از یک layout slide استفاده می‌کند، بنابراین هم از layout و هم از master ارث‌بری می‌کند.

آیا یک ارائه می‌تواند چندین slide master داشته باشد؟

بله. یک ارائه می‌تواند چندین slide master داشته باشد. هنگام نیاز به سیستم‌های بصری یا برندینگ متفاوت برای بخش‌های مختلف، از masterهای متعدد استفاده کنید.

آیا باید placeholders را به یک اسلاید master یا یک اسلاید layout اضافه کنم؟

در اغلب موارد، placeholders را به اسلایدهای layout اضافه کنید. عناصر بصری مشترک و قالب‌بندی مشترک را روی اسلاید master بگذارید و سپس placeholders محتوا را روی layoutهایی که اسلایدهای عادی استفاده می‌کنند، قرار دهید.

آیا می‌توانم یک اسلاید master که هنوز استفاده می‌شود را حذف کنم؟

خیر. اسلاید master که اسلایدهای وابسته دارد، نمی‌تواند به‌صورت مستقیم حذف شود. ابتدا آن اسلایدها را به layoutهای زیر یک master دیگر منتقل کنید یا از روش پاک‌سازی masterهای استفاده‌نشده استفاده کنید که فقط masterهایی را حذف می‌کند که در حال حاضر استفاده نمی‌شوند.

اعمال یا تغییر طرح اسلاید در جاوا مدیریت انتقال‌های اسلاید در ارائه‌ها با استفاده از جاوا