在 JavaScript 中应用或更改幻灯片布局

本页内容简介

在 Aspose.Slides for Node.js（通过 Java）中应用、创建和修改幻灯片布局，添加占位符，移除未使用的布局，并控制页脚可见性。

概述

幻灯片布局定义了标题、文本、图片、图表和表格等占位符的位置和格式。应用布局可以为幻灯片提供一致的结构，同时允许每张幻灯片包含各自的内容。

最常用的布局包括：

标题幻灯片：包含标题和副标题占位符。
标题和内容：包含标题占位符和通用内容占位符。
空白：不包含内容占位符，适用于需要手动定位每个形状的情况。

了解布局继承

演示文稿有三个相关层级：

A 主母版幻灯片 defines the theme, shared formatting, backgrounds, and common objects.
A 布局幻灯片 belongs to a master and defines a particular arrangement of placeholders.
A 普通幻灯片 uses one layout and stores the content entered for that slide.

普通幻灯片从其布局继承主题和格式，布局则从其母版继承。直接在普通幻灯片上设置的值会覆盖该层级的继承值。当创建普通幻灯片时，其占位符形状会根据所选布局生成，而输入到这些占位符的内容属于普通幻灯片。

在创建幻灯片之前，请先向布局中添加所需的占位符。后期向布局添加占位符不会自动为已有的普通幻灯片添加对应的占位符形状。

此关系有两个重要的后果：

更改布局上继承的格式或已有占位符的几何形状会更新所有依赖该布局的幻灯片。在编辑已在使用的布局之前，请检查其依赖的幻灯片并审阅生成的演示文稿。
仍被幻灯片使用的布局无法被删除。请先将其依赖的幻灯片重新分配到其他布局，或仅删除未使用的布局。

欲了解此层级顶部的更多信息，请参阅幻灯片母版。

若需在单个幻灯片或通过共享布局隐藏继承的徽标或装饰性母版形状，请参阅控制母版图形的可见性。示例比较了使用相同母版的两个幻灯片。

选择并应用幻灯片布局

当演示文稿遵循标准 PowerPoint 布局定义时，请使用 SlideLayoutType 值。布局名称可由用户编辑并可本地化，因此除非您能够控制源模板，否则基于名称的选择可靠性较低。

以下示例在第一个母版上查找 Title and Content。如果该布局不可用，则有意回退到 Blank。第二个 null 检查是必需的，因为演示文稿可能仅包含自定义布局。随后通过 Slide.setLayoutSlide 方法将选定的布局应用于第一个普通幻灯片。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let targetLayout = layoutSlides.getByType(titleAndObjectLayoutType);

    if (targetLayout === null) {
        targetLayout = layoutSlides.getByType(blankLayoutType);
    }

    if (targetLayout === null) {
        throw new Error("The first master does not contain a suitable layout slide.");
    }

    presentation.getSlides().get_Item(0).setLayoutSlide(targetLayout);
    presentation.save("output-with-new-layout.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

更改幻灯片的布局不会删除直接添加到幻灯片的普通形状。然而，占位符位置、继承的格式以及现有占位符与新布局之间的对应关系可能会改变，切换到差别较大的布局时请检查输出。

添加布局幻灯片

选择和创建是分开的操作。前面的示例仅选择了已有布局，并未创建新布局。要创建布局，请在目标母版的布局集合上调用 MasterLayoutSlideCollection.add 方法。

以下示例始终添加一个名为 Report Title and Content 的新 Title and Content 布局，然后基于该布局添加普通幻灯片。布局名称在集合中必须唯一。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let masterSlide = presentation.getMasters().get_Item(0);
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let reportLayout = masterSlide.getLayoutSlides().add(titleAndObjectLayoutType, "Report Title and Content");
    presentation.getSlides().addEmptySlide(reportLayout);

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

只有在模板确实需要另一个可重用结构时才添加布局。如果已经存在合适的布局，请选择并复用，而不是创建重复的布局。

向布局幻灯片添加占位符

LayoutSlide.getPlaceholderManager 方法提供一个 LayoutPlaceholderManager 用于向布局添加占位符形状。

PowerPoint 占位符	`LayoutPlaceholderManager` Method
	`addContentPlaceholder(x, y, width, height)`
	`addVerticalContentPlaceholder(x, y, width, height)`
	`addTextPlaceholder(x, y, width, height)`
	`addVerticalTextPlaceholder(x, y, width, height)`
	`addPicturePlaceholder(x, y, width, height)`
	`addChartPlaceholder(x, y, width, height)`
	`addTablePlaceholder(x, y, width, height)`
	`addSmartArtPlaceholder(x, y, width, height)`
	`addMediaPlaceholder(x, y, width, height)`
	`addOnlineImagePlaceholder(x, y, width, height)`

以下示例验证 Blank 布局是否存在，向其添加四个占位符，然后创建使用该修改后布局的普通幻灯片。顺序是有意的：先添加占位符再创建普通幻灯片，以便 Aspose.Slides 能在该幻灯片上生成对应的占位符形状。

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

let presentation = new aspose.slides.Presentation();
try {
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let blankLayout = presentation.getLayoutSlides().getByType(blankLayoutType);

    if (blankLayout === null) {
        throw new Error("The presentation does not contain a Blank layout slide.");
    }

    let placeholderManager = blankLayout.getPlaceholderManager();
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

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

结果：

布局幻灯片上的占位符

Warning

更改已继承的格式或现有布局占位符的几何形状可能影响依赖的幻灯片。新添加的布局占位符不会回填到已有的普通幻灯片。请在演示文稿的副本上测试布局更改并检查每个依赖的幻灯片。

移除未使用的布局幻灯片

使用 Compress.removeUnusedLayoutSlides 方法删除没有普通幻灯片引用的布局。该方法会保留仍在使用的布局。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    aspose.slides.Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("output-without-unused-layouts.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

若要删除特定布局，首先使用其 hasDependingSlides 或 getDependingSlides 方法。调用 LayoutSlide.remove 之前请重新分配所有依赖的幻灯片。尝试删除正在使用的布局会抛出 PptxEditException。

控制布局幻灯片的页脚可见性

布局拥有自己的页脚、幻灯片编号和日期时间占位符。使用 LayoutSlide.getHeaderFooterManager 方法可针对单个布局控制这些占位符。这在例如内容布局需要显示页脚而标题布局不需要时非常有用。

以下示例安全地选择一个布局并使其页脚元素可见：

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let titleAndObjectLayoutType = java.newByte(aspose.slides.SlideLayoutType.TitleAndObject);
    let blankLayoutType = java.newByte(aspose.slides.SlideLayoutType.Blank);
    let layoutSlide = presentation.getLayoutSlides().getByType(titleAndObjectLayoutType);

    if (layoutSlide === null) {
        layoutSlide = presentation.getLayoutSlides().getByType(blankLayoutType);
    }

    if (layoutSlide === null) {
        throw new Error("The presentation does not contain a suitable layout slide.");
    }

    let headerFooterManager = layoutSlide.getHeaderFooterManager();
    headerFooterManager.setFooterVisibility(true);
    headerFooterManager.setSlideNumberVisibility(true);
    headerFooterManager.setDateTimeVisibility(true);
    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

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

控制母版及其子布局的页脚可见性

要在整个母版层级中应用一致的页脚设置，请使用 MasterSlide.getHeaderFooterManager 方法。MasterSlideHeaderFooterManager 的传播方法作用于母版及其依赖的布局幻灯片和普通幻灯片；它们不针对单个普通幻灯片。

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

let presentation = new aspose.slides.Presentation("input.pptx");
try {
    let headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();
    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);
    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

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

常见问题

What Is the Difference Between a Master Slide and a Layout Slide?
母版幻灯片定义演示文稿的主题和共享格式。布局幻灯片属于母版，定义一个可重用的占位符排列。普通幻灯片使用这些布局并存储特定于幻灯片的内容。

Can I Copy a Layout Slide from One Presentation to Another?
可以。使用 addClone 方法将副本添加到目标集合。跨演示文稿复制时，还需检查源布局使用的字体、主题、图像及其他资源。

What Happens When I Modify a Layout That Is Already in Use?
依赖的幻灯片会继承布局的更改，除非它们在本地覆盖了受影响的格式或对象。因此，许多幻灯片的占位符几何和继承样式可能会一次性改变。编辑布局前，可使用 getDependingSlides 确认受影响的幻灯片。

What Happens If I Remove a Layout That Is Still in Use?
Aspose.Slides 会抛出 PptxEditException。请先重新分配依赖的幻灯片，或使用 removeUnusedLayoutSlides 仅删除未被引用的布局。

演示文稿查看器管理 JavaScript 中的演示文稿属性