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

本页内容简介

在 Aspose.Slides for Python via .NET 中管理幻灯片母版：访问、编辑、克隆、比较和删除 PowerPoint 与 OpenDocument 演示文稿中的母版幻灯片。

概述

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

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

层次结构如下：

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

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

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

Inheritance

当相同属性在多个层级上定义时，层级更具体的会覆盖其他。例如，如果母版幻灯片和布局幻灯片都定义了背景，则基于该布局的幻灯片使用布局背景。有关布局幻灯片的更多信息，请参阅应用或更改幻灯片布局。

访问幻灯片母版

在 PowerPoint 中，您可以从视图 > 幻灯片母版 打开幻灯片母版视图。

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

在 Aspose.Slides 中，使用 masters 集合访问母版幻灯片：

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    first_master_slide = presentation.masters[0]
    master_slide_count = len(presentation.masters)
    first_master_layout_slide_count = len(first_master_slide.layout_slides)

    print("Master slides: " + str(master_slide_count))
    print("Layouts in the first master: " + str(first_master_layout_slide_count))

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

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slide = presentation.slides[0]
    layout_slide = slide.layout_slide
    master_slide = layout_slide.master_slide
    master_slide_name = master_slide.name

    print(master_slide_name)

幻灯片母版包含什么

母版幻灯片是一种类似幻灯片的对象。它从 BaseSlide 类继承通用幻灯片行为，因此它公开了许多普通幻灯片和布局幻灯片使用的相同幻灯片属性。特定于母版的成员列在 MasterSlide API 页面上。

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

成员	用途
`background`	设置母版级别的幻灯片背景。
`shapes`	存储放置在母版上的形状，例如徽标、图片框和共享文本。
`layout_slides`	存储属于该母版的布局幻灯片。
`theme_manager`	提供对母版主题 API 的访问。
`header_footer_manager`	控制母版及其子布局的页眉、页脚、日期和幻灯片编号。
`get_depending_slides`	返回通过其布局依赖于该母版的普通幻灯片。

向幻灯片母版添加图像

当您向母版幻灯片添加图像时，它会出现在使用该母版布局的幻灯片上。这对于徽标、水印、装饰条以及其他重复的视觉元素非常有用。

以下示例向第一个母版幻灯片添加徽标：

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]

    with open("logo.png", "rb") as logo_stream:
        logo_bytes = logo_stream.read()

    logo_image = presentation.images.add_image(logo_bytes)

    master_slide.shapes.add_picture_frame(
        slides.ShapeType.RECTANGLE,
        20,
        20,
        80,
        80,
        logo_image)

    presentation.save("presentation-with-logo.pptx", slides.export.SaveFormat.PPTX)

有关图片框的更多信息，请参阅图片框。

控制母版图形的可见性

使用 BaseSlide.show_master_shapes 可以隐藏继承自母版的图形，例如徽标或装饰形状，而无需将其从母版中删除。对相应的幻灯片，将 Slide.show_master_shapes 设置为 False，在需要显示它们的幻灯片上保持为 True。

以下独立示例在母版上创建一个蓝色装饰带，并创建两个使用相同空白布局的幻灯片。该装饰带在第一张幻灯片上可见，在第二张上隐藏。无需输入演示文稿或图像。

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    master_slide = presentation.masters[0]
    layout_slide = master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
    layout_slide.show_master_shapes = True

    slide_height = presentation.slide_size.size.height
    band = master_slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 0, 0, 60, slide_height)
    band.fill_format.fill_type = slides.FillType.SOLID
    band.fill_format.solid_fill_color.color = draw.Color.steel_blue
    band.line_format.fill_format.fill_type = slides.FillType.NO_FILL

    visible_slide = presentation.slides[0]
    visible_slide.layout_slide = layout_slide
    visible_slide.shapes.clear()

    hidden_slide = presentation.slides.add_empty_slide(layout_slide)

    visible_slide.show_master_shapes = True
    hidden_slide.show_master_shapes = False

    presentation.save("master-graphics.pptx", slides.export.SaveFormat.PPTX)

示例使用新演示文稿附带的 Blank 布局，并删除初始幻灯片的占位符。

选择设置的范围

普通幻灯片通过 Slide.layout_slide 和 LayoutSlide.master_slide 使用其母版。对单个幻灯片设置该属性仅影响该幻灯片。将 LayoutSlide.show_master_shapes 设置为 False 会隐藏使用该共享布局的幻灯片的母版图形，即使它们自己的设置为 True。若只在一张幻灯片上隐藏图形，请更改该幻灯片的属性并保持共享布局不变。

该设置在母版幻灯片本身上不受支持作为可见性控制。在母版上始终返回 False，并且将其赋值为 True 会引发异常。应将其应用于普通幻灯片或布局。

将图形与背景区分开

操作	效果
隐藏母版图形	控制继承自母版的形状的可见性，而不删除它们或更改幻灯片自身的形状。
更改幻灯片背景填充	更改背景颜色、渐变或图像。母版图形是独立的形状，仍可在该背景上可见。参见 Presentation Background。
从母版删除形状	删除共享的源形状，使其不再可用于使用该母版的任何幻灯片。

使用占位符

占位符通常在布局幻灯片上定义。母版幻灯片提供这些布局继承的共享样式和主题，而每个布局决定哪些占位符可用以及它们放置的位置。

在 PowerPoint 中，占位符命令可在幻灯片母版视图中使用。

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

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

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]
    blank_layout_slide = master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if blank_layout_slide is None:
        blank_layout_slide = presentation.layout_slides.add(
            master_slide,
            slides.SlideLayoutType.BLANK,
            "Blank")

    blank_layout_slide.placeholder_manager.add_text_placeholder(60, 120, 600, 80)

    presentation.slides.add_empty_slide(blank_layout_slide)
    presentation.save("presentation-with-placeholder.pptx", slides.export.SaveFormat.PPTX)

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

import aspose.pydrawing as draw
import aspose.slides as slides


def find_placeholder(master_slide, placeholder_type):
    for shape in master_slide.shapes:
        if isinstance(shape, slides.AutoShape) and shape.placeholder is not None:
            if shape.placeholder.type == placeholder_type:
                return shape

    return None


with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]
    title_placeholder = find_placeholder(master_slide, slides.PlaceholderType.TITLE)

    if title_placeholder is not None:
        red_gradient_color = draw.Color.from_argb(255, 0, 0)
        purple_gradient_color = draw.Color.from_argb(128, 0, 128)

        title_placeholder.fill_format.fill_type = slides.FillType.GRADIENT
        title_placeholder.fill_format.gradient_format.gradient_shape = slides.GradientShape.LINEAR
        title_placeholder.fill_format.gradient_format.gradient_stops.add(0, red_gradient_color)
        title_placeholder.fill_format.gradient_format.gradient_stops.add(1, purple_gradient_color)

    presentation.save("presentation-title-style.pptx", slides.export.SaveFormat.PPTX)

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

有关更多占位符和文本格式化选项，请参阅在占位符中设置提示文本和文本格式化。

更改幻灯片母版背景

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

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]

    master_slide.background.type = slides.BackgroundType.OWN_BACKGROUND
    master_slide.background.fill_format.fill_type = slides.FillType.SOLID
    master_slide.background.fill_format.solid_fill_color.color = draw.Color.forest_green

    presentation.save("presentation-master-background.pptx", slides.export.SaveFormat.PPTX)

有关相关主题，请参阅 Presentation Background 和 Presentation Theme。

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

使用 MasterSlideCollection 类的 add_clone 方法将母版幻灯片复制到另一个演示文稿中。复制的母版随后可由目标演示文稿中的布局和幻灯片使用。

import aspose.slides as slides

with slides.Presentation("source.pptx") as source_presentation:
    with slides.Presentation("destination.pptx") as destination_presentation:
        source_master_slide = source_presentation.masters[0]
        cloned_master_slide = destination_presentation.masters.add_clone(source_master_slide)

        destination_presentation.save("destination-with-master.pptx", slides.export.SaveFormat.PPTX)

如果需要连同其母版一起克隆普通幻灯片，请参阅 Clone Slides。

添加多个幻灯片母版

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

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

以下示例克隆默认母版，为克隆的母版设置不同的背景，获取该克隆母版下的空白布局，并基于该布局添加新幻灯片：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    default_master_slide = presentation.masters[0]
    section_master_slide = presentation.masters.add_clone(default_master_slide)

    section_master_slide.background.type = slides.BackgroundType.OWN_BACKGROUND
    section_master_slide.background.fill_format.fill_type = slides.FillType.SOLID
    section_master_slide.background.fill_format.solid_fill_color.color = draw.Color.light_steel_blue

    section_blank_layout = section_master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if section_blank_layout is None:
        section_blank_layout = presentation.layout_slides.add(
            section_master_slide,
            slides.SlideLayoutType.BLANK,
            "Section Blank")

    presentation.slides.add_empty_slide(section_blank_layout)
    presentation.save("presentation-with-multiple-masters.pptx", slides.export.SaveFormat.PPTX)

比较幻灯片母版

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

import aspose.slides as slides

with slides.Presentation("first.pptx") as first_presentation:
    with slides.Presentation("second.pptx") as second_presentation:
        first_presentation_master_count = len(first_presentation.masters)
        second_presentation_master_count = len(second_presentation.masters)

        for first_master_index in range(first_presentation_master_count):
            for second_master_index in range(second_presentation_master_count):
                first_master_slide = first_presentation.masters[first_master_index]
                second_master_slide = second_presentation.masters[second_master_index]
                are_master_slides_equal = first_master_slide.equals(second_master_slide)

                if are_master_slides_equal:
                    print(
                        "first.pptx master #{} equals second.pptx master #{}".format(
                            first_master_index,
                            second_master_index))

欲了解更多信息，请参阅 Compare Presentation Slides。

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

使用演示文稿的 last_view 属性（在 ViewProperties 中）来控制 PowerPoint 首次打开的视图。以下示例在幻灯片母版视图中打开演示文稿：

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    presentation.view_properties.last_view = slides.ViewType.SLIDE_MASTER_VIEW
    presentation.save("presentation-master-view.pptx", slides.export.SaveFormat.PPTX)

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

移除未使用的母版幻灯片

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

使用 remove_unused 从 masters 集合中移除未使用的母版：

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    presentation.masters.remove_unused(True)
    presentation.save("presentation-clean.pptx", slides.export.SaveFormat.PPTX)

您也可以使用 Compress 类的低代码 remove_unused_master_slides 方法：

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slides.lowcode.Compress.remove_unused_master_slides(presentation)
    presentation.save("presentation-clean.pptx", slides.export.SaveFormat.PPTX)

常见问题

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

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

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

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

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

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

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

不能。拥有依赖幻灯片的母版幻灯片不能直接安全删除。需要先将这些幻灯片移动到其他母版下的布局，或使用仅删除未使用母版的清理方法。

使用 Python 更改演示文稿中的幻灯片尺寸在 Python 中管理演示文稿的绘图参考线