在 Python 中管理簡報投影片母片

本頁內容簡介

在 Aspose.Slides for Python via .NET 中管理投影片母片：存取、編輯、克隆、比較及移除 PowerPoint 與 OpenDocument 簡報中的母片投影片。

概觀

投影片母片 定義一組投影片的共用設計設定。它可以包含共同的圖形、標誌、背景、文字樣式、主題設定與頁尾設定。在 PowerPoint 中，編輯投影片母片是保持簡報一致性的常見做法，無需在每張投影片上重複相同的格式設定。

Aspose.Slides for Python via .NET 支援相同的模型。簡報可以包含一個或多個母片，每個母片可以包含多個版面投影片。普通投影片通常不直接參考母片，而是使用版面投影片，而該版面投影片屬於某個母片。

層級結構如下：

投影片母片 - 定義共用的設計與主題。
版面投影片 - 定義佔位元件的具體排列以及版面層級的格式。
普通投影片 - 包含實際的簡報內容，使用一個版面投影片。

投影片母片、版面投影片與普通投影片的層級結構

在 Aspose.Slides 中，投影片母片由 MasterSlide 類別表示。簡報中的所有母片可透過 Presentation.masters 集合取得。

繼承

當相同屬性在多個層級皆被定義時，較具體的層級會優先。舉例而言，若母片與版面投影片同時定義背景，基於該版面的投影片會使用版面背景。欲瞭解更多關於版面投影片的資訊，請參閱套用或變更投影片版面配置。

存取投影片母片

在 PowerPoint 中，可從 View > Slide Master 開啟投影片母片檢視。

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)

欲瞭解圖片框的更多資訊，請參閱 Picture Frame。

使用佔位元件

佔位元件通常定義於版面投影片上。母片提供共用的樣式與主題，版面則決定哪些佔位元件可用以及它們的放置位置。

在 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)

已格式化的標題佔位元件會被普通投影片繼承

欲取得更多佔位元件與文字格式化選項，請參閱 Set Prompt Text in Placeholder 與 Text Formatting。

變更投影片母片背景

母片背景會被版面與未覆寫背景的投影片繼承。以下範例為第一個母片設定純色背景：

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。

將投影片母片檢視設為預設檢視

在簡報的 ViewProperties 中使用 last_view 屬性，可控制 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)

您也可以使用低程式碼的 remove_unused_master_slides 方法，該方法屬於 Compress 類別：

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 中管理簡報的繪圖參考線