在 .NET 中管理演示文稿主题

演示文稿主题定义了设计元素的属性。选择演示文稿主题时，实际上是选择了一组特定的视觉元素及其属性。

在 PowerPoint 中，主题包括颜色、fonts、background styles 和效果。

theme-constitues

Change Theme Color

PowerPoint 主题使用一组特定颜色来表示幻灯片上不同元素的颜色。如果不喜欢这些颜色，可以通过为主题应用新颜色来更改它们。为了让您选择新的主题颜色，Aspose.Slides 在 SchemeColor 枚举中提供了相应的值。

以下 C# 代码演示如何更改主题的强调颜色：

using (Presentation pres = new Presentation())
    
{
    IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

    shape.FillFormat.FillType = FillType.Solid;

    shape.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
}

您可以通过以下方式确定结果颜色的有效值：

var fillEffective = shape.FillFormat.GetEffective();

Console.WriteLine($"{fillEffective.SolidFillColor.Name} ({fillEffective.SolidFillColor})"); // ff8064a2 (颜色 [A=255, R=128, G=100, B=162])

为了进一步演示颜色更改操作，我们创建另一个元素并将（初始操作得到的）强调颜色分配给它。随后在主题中更改颜色：

IAutoShape otherShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 120, 100, 100);

otherShape.FillFormat.FillType = FillType.Solid;

otherShape.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;

pres.MasterTheme.ColorScheme.Accent4.Color = Color.Red;

新颜色会自动应用到两个元素上。

Set Theme Color from an Additional Palette

当您对主体主题颜色（1）进行亮度变换时，会形成附加调色板（2）中的颜色。随后可以设置并获取这些主题颜色。

additional-palette-colors

1 - 主体主题颜色

2 - 附加调色板中的颜色

以下 C# 代码演示如何从主体主题颜色获取附加调色板颜色并将其用于形状：

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    // 强调色 4
    IShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 50, 50);

    shape1.FillFormat.FillType = FillType.Solid;
    shape1.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;

    // 强调色 4，亮度提升 80%
    IShape shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 70, 50, 50);

    shape2.FillFormat.FillType = FillType.Solid;
    shape2.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
    shape2.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.2f);
    shape2.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.8f);

    // 强调色 4，亮度提升 60%
    IShape shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 130, 50, 50);

    shape3.FillFormat.FillType = FillType.Solid;
    shape3.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
    shape3.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.4f);
    shape3.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.6f);

    // 强调色 4，亮度提升 40%
    IShape shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 190, 50, 50);

    shape4.FillFormat.FillType = FillType.Solid;
    shape4.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
    shape4.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.6f);
    shape4.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.4f);

    // 强调色 4，更暗 25%
    IShape shape5 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 250, 50, 50);

    shape5.FillFormat.FillType = FillType.Solid;
    shape5.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
    shape5.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.75f);

    // 强调色 4，更暗 50%
    IShape shape6 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 310, 50, 50);

    shape6.FillFormat.FillType = FillType.Solid;
    shape6.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
    shape6.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.5f);

    presentation.Save("example.pptx", SaveFormat.Pptx);
}

Change Theme Font

为使您能够为主题及其他用途选择字体，Aspose.Slides 使用这些特殊标识符（与 PowerPoint 中使用的类似）：

+mn-lt - 正文字体 Latin（Minor Latin Font）
+mj-lt - 标题字体 Latin（Major Latin Font）
+mn-ea - 正文字体 East Asian（Minor East Asian Font）
+mj-ea - 正文字体 East Asian（Minor East Asian Font）

以下 C# 代码演示如何为主题元素分配 Latin 字体：

IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

Paragraph paragraph = new Paragraph();

Portion portion = new Portion("Theme text format");

paragraph.Portions.Add(portion);

shape.TextFrame.Paragraphs.Add(paragraph);

portion.PortionFormat.LatinFont = new FontData("+mn-lt");

以下 C# 代码演示如何更改演示文稿主题字体：

pres.MasterTheme.FontScheme.Minor.LatinFont = new FontData("Arial");

所有文本框中的字体都会被更新。

TIP

您可能想查看 PowerPoint fonts。

Change Theme Background Style

默认情况下，PowerPoint 应用提供 12 种预定义背景，但在典型演示文稿中只会保存其中的 3 种。

todo:image_alt_text

例如，在 PowerPoint 应用中保存演示文稿后，您可以运行以下 C# 代码来获取演示文稿中预定义背景的数量：

using (Presentation pres = new Presentation("pres.pptx"))

{
    int numberOfBackgroundFills = pres.MasterTheme.FormatScheme.BackgroundFillStyles.Count;

    Console.WriteLine($"Number of background fill styles for theme is {numberOfBackgroundFills}");
}

使用 FormatScheme 类中的 BackgroundFillStyles 属性，您可以在 PowerPoint 主题中添加或访问背景样式。

以下 C# 代码演示如何为演示文稿设置背景：

pres.Masters[0].Background.StyleIndex = 2;

索引指南：0 表示无填充。索引从 1 开始。

TIP

您可能想查看 PowerPoint Background。

Change Theme Effect

PowerPoint 主题通常为每个样式数组包含 3 个值。这些数组组合成 3 种效果：subtle、moderate 和 intense。例如，以下是将这些效果应用于特定形状后的结果：

todo:image_alt_text

使用来自 FormatScheme 类的 3 个属性（FillStyles、LineStyles、EffectStyles），您可以更改主题中的元素（比 PowerPoint 中的选项更灵活）。

以下 C# 代码演示如何通过更改元素的部分属性来更改主题效果：

using (Presentation pres = new Presentation("Subtle_Moderate_Intense.pptx"))
{
    pres.MasterTheme.FormatScheme.LineStyles[0].FillFormat.SolidFillColor.Color = Color.Red;

    pres.MasterTheme.FormatScheme.FillStyles[2].FillType = FillType.Solid;

    pres.MasterTheme.FormatScheme.FillStyles[2].SolidFillColor.Color = Color.ForestGreen;

    pres.MasterTheme.FormatScheme.EffectStyles[2].EffectFormat.OuterShadowEffect.Distance = 10f;

    pres.Save("Design_04_Subtle_Moderate_Intense-out.pptx", SaveFormat.Pptx);
}

更改后在填充颜色、填充类型、阴影效果等方面的效果如下：

todo:image_alt_text

FAQ

我可以在不更改母版的情况下将主题仅应用于单个幻灯片吗？

可以。Aspose.Slides 支持幻灯片级别的主题覆盖，您可以仅在该幻灯片上应用本地主题，同时保持母版主题不变（通过 SlideThemeManager）。

将主题从一个演示文稿迁移到另一个演示文稿的最安全方式是什么？

使用 Clone slides 将幻灯片及其母版一起克隆到目标演示文稿中。这样可以保留原始母版、布局以及关联的主题，从而保持外观一致。

如何查看所有继承和覆盖后的“有效”值？

使用 API 的 “effective” views 来获取主题/颜色/字体/效果的最终解析属性。

在 .NET 中管理演示文稿背景