在 Python 中管理 PowerPoint 簡報主題

簡介

簡報主題定義其設計元素的屬性。當您選擇主題時，即是選取一套協調一致的視覺元素及其屬性。

在 PowerPoint 中，主題包含顏色、字型、背景樣式以及效果。

theme-constituents

變更主題顏色

PowerPoint 主題為投影片上的不同元素使用特定的顏色集合。如果您不喜歡預設值，可以透過套用新的主題顏色來變更它們。為了讓您選取新的主題顏色，Aspose.Slides 在 SchemeColor 列舉中提供了相應的值。

此 Python 程式碼顯示如何變更主題的強調色：

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

您可以如下方式取得結果顏色的實際值：

fill_effective = shape.fill_format.get_effective()
print("{0} ({1})".format(fill_effective.solid_fill_color.name, fill_effective.solid_fill_color))

# 範例輸出:
#
# ff8064a2 (顏色 [A=255, R=128, G=100, B=162])

為了進一步示範顏色變更，我們建立另一個元素，將其指派為初始步驟的強調色，然後更新主題顏色。

other_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 120, 100, 100)
other_shape.fill_format.fill_type = slides.FillType.SOLID
other_shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

presentation.master_theme.color_scheme.accent4.color = draw.Color.red

新顏色會自動套用到兩個元素。

從額外調色盤設定主題顏色

當您對主題主要顏色 (1) 套用亮度變換時，會產生來自額外調色盤 (2) 的顏色。之後即可設定與取得這些主題顏色。

additional-palette-colors

1 — 主題主要顏色
2 — 來自額外調色盤的顏色

此 Python 程式碼示範如何從主題主要顏色衍生額外調色盤顏色，並在圖形中使用：

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # 強調色 4
    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 50, 50)

    shape1.fill_format.fill_type = slides.FillType.SOLID
    shape1.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

    # 強調色 4，較亮 80%
    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 70, 50, 50)

    shape2.fill_format.fill_type = slides.FillType.SOLID
    shape2.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.2)
    shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.8)

    # 強調色 4，較亮 60%
    shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 130, 50, 50)

    shape3.fill_format.fill_type = slides.FillType.SOLID
    shape3.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.4)
    shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.6)

    # 強調色 4，較亮 40%
    shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 190, 50, 50)

    shape4.fill_format.fill_type = slides.FillType.SOLID
    shape4.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.6)
    shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.4)

    # 強調色 4，較暗 25%
    shape5 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 250, 50, 50)

    shape5.fill_format.fill_type = slides.FillType.SOLID
    shape5.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape5.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.75)

    # 強調色 4，較暗 50%
    shape6 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 50, 50)

    shape6.fill_format.fill_type = slides.FillType.SOLID
    shape6.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape6.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.5)

    presentation.save("example.pptx", slides.export.SaveFormat.PPTX)

對映 `SchemeColor` 到 `ColorScheme` 顏色

當您使用 SchemeColor 時，可能會注意到它包含以下主題顏色值：

BACKGROUND1, BACKGROUND2, TEXT1, and TEXT2.

然而，Presentation.master_theme.color_scheme 會回傳 ColorScheme，其對應的顏色分別為：

dark1, dark2, light1, and light2.

這個差異僅在命名上。這些值指向相同的主題顏色槽，且對映關係固定：

TEXT1 = dark1
BACKGROUND1 = light1
TEXT2 = dark2
BACKGROUND2 = light2

TEXT/BACKGROUND 與 dark/light 之間沒有動態轉換，它們只是相同主題顏色的替代名稱。

此命名差異來源於 Microsoft Office 的術語。較舊的 Office 版本使用 Dark 1, Light 1, Dark 2, Light 2，而較新的 UI 版本則將相同槽位顯示為 Text 1, Background 1, Text 2, Background 2.

變更主題字型

為了讓您能為主題與其他用途選取字型，Aspose.Slides 使用以下特殊識別碼（類似於 PowerPoint）：

+mn-lt — 正文字型拉丁文（次要拉丁字型）
+mj-lt — 標題字型拉丁文（主要拉丁字型）
+mn-ea — 正文字型東亞語系（次要東亞字型）
+mj-ea — 標題字型東亞語系（主要東亞字型）

此 Python 程式碼顯示如何將拉丁字型指派給主題元素：

portion = slides.Portion("Theme text format")
portion.portion_format.latin_font = slides.FontData("+mn-lt")

paragraph = slides.Paragraph()
paragraph.portions.add(portion)

shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
shape.text_frame.paragraphs.add(paragraph)

此 Python 範例示範如何變更簡報的主題字型：

presentation.master_theme.font_scheme.minor.latin_font = slides.FontData("Arial")

所有文字方塊皆會更新為新字型。

TIP

如需更多資訊，請參閱 Master PowerPoint Fonts with Python。

變更主題背景樣式

預設情況下，PowerPoint 提供 12 種預先定義的背景，但一般簡報僅儲存其中的 3 種。

todo:image_alt_text

例如，您在 PowerPoint 中儲存簡報後，可以執行以下 Python 程式碼，以判斷其中包含多少預先定義的背景：

with slides.Presentation() as presentation:
    number_of_background_fills = len(presentation.master_theme.format_scheme.background_fill_styles)
    print(f"Number of theme background fill styles: {number_of_background_fills}")

使用來自 FormatScheme 類別的 background_fill_styles 屬性，您可以在 PowerPoint 主題中新增或存取背景樣式。

此 Python 範例示範如何設定簡報背景：

presentation.masters[0].background.style_index = 2  # 0 表示無填充；索引從 1 開始。

TIP

如需更多資訊，請參閱 Manage Presentation Backgrounds in Python。

變更主題效果

PowerPoint 主題通常在每個樣式陣列中包含三個值。這些陣列結合為三個效果層級：細緻、適中與強烈。例如，以下是將這些效果套用到特定圖形時的結果：

todo:image_alt_text

使用來自 FormatScheme 類別的三個屬性—FillStyles、LineStyles、EffectStyles，您可以比在 PowerPoint 中更彈性地修改主題元素。

此 Python 程式碼顯示如何透過變更這些元素的部份屬性來變更主題效果：

with slides.Presentation("sample.pptx") as presentation:
    presentation.master_theme.format_scheme.line_styles[0].fill_format.solid_fill_color.color = draw.Color.red
    presentation.master_theme.format_scheme.fill_styles[2].fill_type = slides.FillType.SOLID
    presentation.master_theme.format_scheme.fill_styles[2].solid_fill_color.color = draw.Color.forest_green
    presentation.master_theme.format_scheme.effect_styles[2].effect_format.outer_shadow_effect.distance = 10

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

產生的變更包括填色、填充類型、陰影效果以及其他屬性的更新：

todo:image_alt_text

常見問題

我可以在不更改母片的情況下，將主題套用到單一投影片嗎？

可以。Aspose.Slides 支援投影片層級的主題覆寫，您可以僅將本機主題套用至該投影片，同時保持母片主題不變（透過 SlideThemeManager）。

將主題從一個簡報搬移到另一個簡報的最安全方式是什麼？

使用 Clone slides 搭配其母片一起複製到目標簡報。這會保留原始的母片、版面配置以及相關的主題，確保外觀一致。

如何查看所有繼承與覆寫後的「有效」值？

使用 API 的「“effective” views」來取得主題、顏色、字型、效果的最終解析屬性。

在 Python 中管理簡報背景

在 Python 中管理 PowerPoint 簡報主題

簡介

變更主題顏色

從額外調色盤設定主題顏色

對映 SchemeColor 到 ColorScheme 顏色

變更主題字型

TIP

變更主題背景樣式

TIP

變更主題效果

常見問題

對映 `SchemeColor` 到 `ColorScheme` 顏色