使用 Python via Java 管理簡報投影片母片

本頁內容簡介

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

概觀

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

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

層級結構如下：

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

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

Inheritance

當同一屬性在多個層級中都有定義時，較具體的層級會優先。舉例來說，若母片投影片與版面投影片同時定義了背景，則基於該版面的投影片會使用版面的背景。欲取得更多關於版面投影片的資訊，請參閱 Apply or Change Slide Layouts。

存取投影片母片

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

在 Aspose.Slides 中，使用 Presentation.getMasters 集合來存取母片投影片：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    first_master_slide = presentation.getMasters().get_Item(0)
    master_slide_count = presentation.getMasters().size()
    first_master_layout_slide_count = first_master_slide.getLayoutSlides().size()

    print(f"Master slides: {master_slide_count}")
    print(f"Layouts in the first master: {first_master_layout_slide_count}")
finally:
    presentation.dispose()

您也可以透過普通投影片的版面取得其所使用的母片投影片：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    layout_slide = slide.getLayoutSlide()
    master_slide = layout_slide.getMasterSlide()
    master_slide_name = master_slide.getName()

    print(master_slide_name)
finally:
    presentation.dispose()

投影片母片包含哪些內容

母片投影片是一種類似投影片的物件。它繼承自 BaseSlide，因此具有許多普通投影片與版面投影片共用的屬性。母片專屬的成員列於 MasterSlide API 頁面。

常用的母片投影片成員包括：

成員	用途
getBackground	設定母片層級的投影片背景。
getShapes	儲存放置於母片上的圖形，例如標誌、圖片框和共用文字。
getLayoutSlides	儲存屬於母片的版面投影片。
getThemeManager	提供存取母片主題的 API。
getHeaderFooterManager	控制母片及其子版面的頁首、頁尾、日期與投影片編號。
getDependingSlides	返回依賴於母片且透過版面使用的普通投影片。

在投影片母片上新增圖像

將圖像加入母片投影片時，會顯示在使用該母片版面的投影片上。這對於標誌、水印、裝飾條紋或其他需重複出現的視覺元素非常有用。

以下範例在第一個母片投影片上加入標誌：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Images, Presentation, SaveFormat, ShapeType

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    logo = Images.fromFile("logo.png")
    try:
        logo_image = presentation.getImages().addImage(logo)
        master_slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 80, 80, logo_image)
    finally:
        logo.dispose()

    presentation.save("presentation-with-logo.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

欲取得更多關於圖片框的資訊，請參閱 Picture Frame。

使用佔位元

佔位元通常在版面投影片上定義。母片投影片提供共用的樣式與主題，供這些版面繼承，而每個版面決定哪些佔位元可用以及它們的放置位置。

在 PowerPoint 中，佔位元指令可在投影片母片檢視中使用。

若要使用 Aspose.Slides 新增佔位元，請對屬於母片的版面投影片進行操作：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SlideLayoutType

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    blank_layout_slide = master_slide.getLayoutSlides().getByType(SlideLayoutType.Blank)

    if blank_layout_slide is None:
        blank_layout_slide = master_slide.getLayoutSlides().add(SlideLayoutType.Blank, "Blank")

    blank_layout_slide.getPlaceholderManager().addTextPlaceholder(60, 120, 600, 80)

    presentation.getSlides().addEmptySlide(blank_layout_slide)
    presentation.save("presentation-with-placeholder.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

您也可以格式化已存在於母片投影片上的佔位元圖形。以下範例找到標題佔位元並套用線性漸層填色：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, FillType, GradientShape, PlaceholderType, Presentation, SaveFormat

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    title_placeholder = None

    for shape in master_slide.getShapes():
        if isinstance(shape, AutoShape):
            if shape.getPlaceholder() is not None and shape.getPlaceholder().getType() == PlaceholderType.Title:
                title_placeholder = shape
                break

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

        title_placeholder.getFillFormat().setFillType(FillType.Gradient)
        title_placeholder.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear)
        title_placeholder.getFillFormat().getGradientFormat().getGradientStops().add(jpype.JFloat(0.0), red_gradient_color)
        title_placeholder.getFillFormat().getGradientFormat().getGradientStops().add(jpype.JFloat(1.0), purple_gradient_color)

    presentation.save("presentation-title-style.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

變更投影片母片背景

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    master_background_color = Color.GREEN

    master_slide.getBackground().setType(BackgroundType.OwnBackground)
    master_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    master_slide.getBackground().getFillFormat().getSolidFillColor().setColor(master_background_color)

    presentation.save("presentation-master-background.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

相關主題請參閱 Presentation Background 與 Presentation Theme。

將投影片母片複製到其他簡報

使用 MasterSlideCollection.addClone 可將母片投影片複製到另一個簡報。複製後的母片即可供目標簡報的版面與投影片使用。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

source_presentation = Presentation("source.pptx")
destination_presentation = Presentation("destination.pptx")
try:
    source_master_slide = source_presentation.getMasters().get_Item(0)
    cloned_master_slide = destination_presentation.getMasters().addClone(source_master_slide)

    destination_presentation.save("destination-with-master.pptx", SaveFormat.Pptx)
finally:
    source_presentation.dispose()
    destination_presentation.dispose()

若需同時複製普通投影片及其母片，請參閱 Clone Slides。

新增多個投影片母片

簡報可以包含多個母片投影片。當不同章節需要不同的品牌、版面結構或主題設定時，這非常實用。

以下範例會複製預設母片、為複製品設定不同的背景、在該複製母片下建立版面，並依據該版面新增投影片：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, SlideLayoutType

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    default_master_slide = presentation.getMasters().get_Item(0)
    section_master_slide = presentation.getMasters().addClone(default_master_slide)
    section_master_background_color = Color.LIGHT_GRAY

    section_master_slide.getBackground().setType(BackgroundType.OwnBackground)
    section_master_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    section_master_slide.getBackground().getFillFormat().getSolidFillColor().setColor(section_master_background_color)

    source_blank_layout = default_master_slide.getLayoutSlides().getByType(SlideLayoutType.Blank)
    if source_blank_layout is None:
        source_blank_layout = default_master_slide.getLayoutSlides().get_Item(0)

    section_blank_layout = section_master_slide.getLayoutSlides().addClone(source_blank_layout)

    presentation.getSlides().addEmptySlide(section_blank_layout)
    presentation.save("presentation-with-multiple-masters.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

比較投影片母片

母片投影片可使用從 BaseSlide 繼承的 equals 方法進行比較。比較會檢查結構與靜態內容，例如圖形、文字、格式、動畫與其他投影片設定。它不會比較唯一識別碼（如投影片 ID）或動態佔位元值（如當前日期）。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

first_presentation = Presentation("first.pptx")
second_presentation = Presentation("second.pptx")
try:
    first_presentation_master_count = first_presentation.getMasters().size()
    second_presentation_master_count = second_presentation.getMasters().size()

    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.getMasters().get_Item(first_master_index)
            second_master_slide = second_presentation.getMasters().get_Item(second_master_index)
            are_master_slides_equal = first_master_slide.equals(second_master_slide)

            if are_master_slides_equal:
                print(f"first.pptx master #{first_master_index} equals second.pptx master #{second_master_index}")
finally:
    first_presentation.dispose()
    second_presentation.dispose()

欲取得更多資訊，請參閱 Compare Presentation Slides。

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

使用 ViewProperties 上的 setLastView 方法，可控制 PowerPoint 首次開啟時的檢視模式。以下範例在投影片母片檢視中開啟簡報：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ViewType

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

欲取得更多檢視設定，請參閱 Save Presentation。

移除未使用的投影片母片

簡報有時會包含已不再被任何普通投影片使用的母片投影片。移除未使用的母片可減少檔案大小並簡化範本維護。

使用 removeUnused 方法，從 Presentation.getMasters 集合中移除未使用的母片：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    presentation.getMasters().removeUnused(True)
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

您也可以使用低程式碼的 Compress.removeUnusedMasterSlides 方法：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Compress, Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    Compress.removeUnusedMasterSlides(presentation)
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常見問題

投影片母片與版面投影片有何差異？

投影片母片定義共用的設計設定，如主題、背景、共用圖形與文字樣式。版面投影片屬於母片，並定義佔位元的具體排列。普通投影片使用版面投影片，因此會同時繼承版面與母片的設定。

一個簡報可以包含多個投影片母片嗎？

可以。簡報可以包含多個投影片母片。當不同章節需要不同的視覺系統或品牌時，請使用多個母片。

應該在母片還是版面投影片上新增佔位元？

大多數情況下，應在版面投影片上新增佔位元。將共用的視覺元素與共用格式放在母片上，然後在普通投影片會使用的版面上放置內容佔位元。

我可以刪除仍在使用中的母片嗎？

不行。具有相依投影片的母片無法直接安全地刪除。請先將這些投影片移動至其他母片的版面，或使用僅移除未使用母片的清理方法。