在 JavaScript 中管理演示文稿幻灯片母版

概述

幻灯片母版 定义了一组幻灯片的共享设计设置。它可以包含公共形状、徽标、背景、文本样式、主题设置和页脚设置。在 PowerPoint 中,编辑幻灯片母版是保持演示文稿一致而无需在每张幻灯片上重复相同格式的常用方式。

Aspose.Slides for Node.js via Java 支持相同的模型。一个演示文稿可以包含一个或多个母版幻灯片,每个母版幻灯片可以包含若干布局幻灯片。普通幻灯片通常不会直接引用母版幻灯片,而是使用布局幻灯片,该布局幻灯片属于某个母版幻灯片。

层级结构为:

  1. 幻灯片母版 - 定义共享的设计和主题。
  2. 布局幻灯片 - 定义占位符的具体排列和布局级格式。
  3. 普通幻灯片 - 包含实际的演示内容并使用一个布局幻灯片。

母版幻灯片、布局幻灯片和普通幻灯片的层次结构

在 Aspose.Slides 中,幻灯片母版由 MasterSlide 类表示。演示文稿中的所有母版幻灯片可通过 Presentation.getMasters() 集合获取。

访问幻灯片母版

在 PowerPoint 中,您可以通过 视图 > 幻灯片母版 打开幻灯片母版视图。

PowerPoint 视图选项卡上的 幻灯片母版 命令

在 Aspose.Slides 中,使用 getMasters() 集合访问母版幻灯片:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

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

您还可以通过普通幻灯片的布局获取其使用的母版幻灯片:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let layoutSlide = slide.getLayoutSlide();
    let masterSlide = layoutSlide.getMasterSlide();
    let masterSlideName = masterSlide.getName();

    console.log(masterSlideName);
} finally {
    presentation.dispose();
}

幻灯片母版包含的内容

母版幻灯片是类似幻灯片的对象。它继承自 BaseSlide,因此暴露了许多普通幻灯片和布局幻灯片使用的相同属性。母版特有的成员列在 MasterSlide API 页面上。

常用的母版幻灯片成员包括:

成员 用途
getBackground() 设置母版级幻灯片背景。
getShapes() 存储放置在母版上的形状,如徽标、图片框和共享文本。
getLayoutSlides() 存储属于该母版的布局幻灯片。
getThemeManager() 提供对母版主题 API 的访问。
getHeaderFooterManager() 控制母版及其子布局的页眉、页脚、日期和幻灯片编号。
getDependingSlides() 返回通过其布局依赖于该母版的普通幻灯片。

向幻灯片母版添加图片

向母版幻灯片添加图片后,使用该母版布局的幻灯片都会显示该图片。这对于徽标、水印、装饰条以及其他重复的视觉元素非常有用。

下面的示例向第一张母版幻灯片添加徽标:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

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

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

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

有关图片框的更多信息,请参阅 Picture Frame

使用占位符

占位符通常在布局幻灯片上定义。母版幻灯片提供共享的样式和主题,布局则决定哪些占位符可用以及它们的位置。

在 PowerPoint 中,占位符命令位于幻灯片母版视图中。

PowerPoint 幻灯片母版视图中的 插入占位符 命令

要使用 Aspose.Slides 添加新占位符,请操作属于母版的布局幻灯片:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let masterSlide = presentation.getMasters().get_Item(0);
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let blankLayoutSlide = masterSlide.getLayoutSlides().getByType(blankLayoutType);

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

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

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

您也可以格式化母版幻灯片上已有的占位符形状。下面的示例查找标题占位符并应用线性渐变填充:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let masterSlide = presentation.getMasters().get_Item(0);
    let titlePlaceholder = null;
    let masterShapes = masterSlide.getShapes();
    let masterShapeCount = masterShapes.size();

    for (let masterShapeIndex = 0; masterShapeIndex < masterShapeCount; masterShapeIndex++) {
        let shape = masterShapes.get_Item(masterShapeIndex);

        if (java.instanceOf(shape, "com.aspose.slides.AutoShape")) {
            let placeholder = shape.getPlaceholder();

            if (placeholder !== null && placeholder.getType() === aspose.slides.PlaceholderType.Title) {
                titlePlaceholder = shape;
                break;
            }
        }
    }

    if (titlePlaceholder !== null) {
        let gradientFillType = java.newByte(aspose.slides.FillType.Gradient);
        let linearGradientShape = java.newByte(aspose.slides.GradientShape.Linear);
        let redGradientColor = java.newInstanceSync("java.awt.Color", 255, 0, 0);
        let purpleGradientColor = java.newInstanceSync("java.awt.Color", 128, 0, 128);

        titlePlaceholder.getFillFormat().setFillType(gradientFillType);
        titlePlaceholder.getFillFormat().getGradientFormat().setGradientShape(linearGradientShape);
        titlePlaceholder.getFillFormat().getGradientFormat().getGradientStops().add(0.0, redGradientColor);
        titlePlaceholder.getFillFormat().getGradientFormat().getGradientStops().add(1.0, purpleGradientColor);
    }

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

普通幻灯片继承的已格式化标题占位符

有关占位符和文本格式化的更多选项,请参阅 Set Prompt Text in PlaceholderText Formatting

更改幻灯片母版背景

母版背景会被布局和未覆盖该背景的幻灯片继承。下面的示例为第一张母版幻灯片设置纯色背景:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let masterSlide = presentation.getMasters().get_Item(0);
    let ownBackgroundType = java.newByte(aspose.slides.BackgroundType.OwnBackground);
    let solidFillType = java.newByte(aspose.slides.FillType.Solid);
    let masterBackgroundColor = java.getStaticFieldValue("java.awt.Color", "GREEN");

    masterSlide.getBackground().setType(ownBackgroundType);
    masterSlide.getBackground().getFillFormat().setFillType(solidFillType);
    masterSlide.getBackground().getFillFormat().getSolidFillColor().setColor(masterBackgroundColor);

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

相关主题请参阅 Presentation BackgroundPresentation Theme

将幻灯片母版克隆到另一个演示文稿

使用 MasterSlideCollection.addClone 可将母版幻灯片复制到另一个演示文稿。复制后的母版随后可被目标演示文稿中的布局和幻灯片使用。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

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

如果需要同时克隆普通幻灯片及其母版,请参阅 Clone Slides

添加多个幻灯片母版

一个演示文稿可以包含多个母版幻灯片。当不同章节需要不同的品牌、页面结构或主题设置时,这非常有用。

PowerPoint 插入和管理母版幻灯片的命令

下面的示例克隆默认母版,为克隆母版设置不同的背景,在该克隆母版下创建布局,并基于该布局添加新幻灯片:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let defaultMasterSlide = presentation.getMasters().get_Item(0);
    let sectionMasterSlide = presentation.getMasters().addClone(defaultMasterSlide);
    let ownBackgroundType = java.newByte(aspose.slides.BackgroundType.OwnBackground);
    let solidFillType = java.newByte(aspose.slides.FillType.Solid);
    let sectionMasterBackgroundColor = java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY");

    sectionMasterSlide.getBackground().setType(ownBackgroundType);
    sectionMasterSlide.getBackground().getFillFormat().setFillType(solidFillType);
    sectionMasterSlide.getBackground().getFillFormat().getSolidFillColor().setColor(sectionMasterBackgroundColor);

    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let sourceBlankLayout = defaultMasterSlide.getLayoutSlides().getByType(blankLayoutType);
    if (sourceBlankLayout === null) {
        sourceBlankLayout = defaultMasterSlide.getLayoutSlides().get_Item(0);
    }

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

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

比较幻灯片母版

母版幻灯片可以使用从 BaseSlide 继承的 equals 方法进行比较。比较会检查结构和静态内容,如形状、文本、格式、动画以及其他幻灯片设置。它不比较唯一标识符(如幻灯片 ID)或动态占位符值(如当前日期)。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

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

            if (areMasterSlidesEqual) {
                console.log(
                    "first.pptx master #" + firstMasterIndex +
                    " equals second.pptx master #" + secondMasterIndex);
            }
        }
    }
} finally {
    firstPresentation.dispose();
    secondPresentation.dispose();
}

更多信息请参阅 Compare Presentation Slides

将幻灯片母版视图设为默认视图

ViewProperties 上使用 setLastView 方法可控制 PowerPoint 首次打开时的视图。下面的示例在幻灯片母版视图中打开演示文稿:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let slideMasterViewType = java.newByte(aspose.slides.ViewType.SlideMasterView);

    presentation.getViewProperties().setLastView(slideMasterViewType);
    presentation.save("presentation-master-view.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

有关更多视图设置,请参阅 Save Presentation

删除未使用的母版幻灯片

演示文稿有时会包含已不再被任何普通幻灯片使用的母版幻灯片。删除未使用的母版可以减小文件大小并简化模板维护。

使用 removeUnusedgetMasters() 集合中删除未使用的母版:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

您也可以使用低代码的 Compress.removeUnusedMasterSlides 方法:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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

常见问答

幻灯片母版和布局幻灯片有什么区别?

幻灯片母版定义共享的设计设置,如主题、背景、公共形状和文本样式。布局幻灯片属于某个母版,定义占位符的具体排列。普通幻灯片使用布局幻灯片,因此它既继承布局也继承母版的设置。

一个演示文稿可以包含多个幻灯片母版吗?

可以。一个演示文稿可以包含多个幻灯片母版。不同章节需要不同的视觉系统或品牌时,请使用多个母版。

应该在母版幻灯片还是布局幻灯片上添加占位符?

大多数情况下应在布局幻灯片上添加占位符。将共享的视觉元素和共享的格式放在母版上,然后在普通幻灯片使用的布局上放置内容占位符。

我可以删除仍在使用的母版幻灯片吗?

不能。仍有从属幻灯片的母版不能直接安全删除。请先将这些幻灯片移动到另一个母版下的布局,或使用仅删除未使用母版的清理方法。