如何使用C#为PowerPoint中形状的线条/边框应用渐变效果

PowerPoint 2016 UI层面支持直接为形状边框应用渐变，但Interop组件没有在LineFormat对象下直接暴露渐变配置入口，实际边框渐变的配置入口挂载在Line.Fill属性下，配置逻辑和形状本身的填充渐变完全一致。

前置准备 #

• 项目添加Microsoft.Office.Interop.PowerPoint 16.0版本引用，匹配本机安装的Office 2016版本
• 引入所需命名空间：

using Microsoft.Office.Core;
using Microsoft.Office.Interop.PowerPoint;
using System.Drawing;

实现代码 #

// 获取当前活动幻灯片
Slide activeSlide = Globals.ThisAddIn.Application.ActiveWindow.View.Slide;
// 示例：新增测试矩形
Shape targetShape = activeSlide.Shapes.AddShape(
    MsoAutoShapeType.msoShapeRectangle,
    left: 80,
    top: 80,
    width: 400,
    height: 250
);

// 配置边框基础参数
targetShape.Line.Visible = MsoTriState.msoTrue;
targetShape.Line.Weight = 8f; // 边框需设置足够粗细，否则渐变效果无法清晰显示

// 配置边框渐变
targetShape.Line.Fill.TwoColorGradient(
    Style: MsoGradientStyle.msoGradientDiagonalUp,
    Variant: 1
);
// 配置渐变起止颜色
targetShape.Line.Fill.ForeColor.RGB = Color.FromArgb(33, 133, 208).ToArgb();
targetShape.Line.Fill.BackColor.RGB = Color.FromArgb(255, 185, 0).ToArgb();

// 如需自定义多段渐变，可通过GradientStops插入自定义光圈
targetShape.Line.Fill.GradientStops.Insert(
    RGB: Color.FromArgb(0, 178, 148).ToArgb(),
    Position: 0.5f // 光圈位置取值范围0-1，对应渐变路径的起点到终点
);

注意事项 #

• 不要在LineFormat对象下查找渐变相关方法，所有边框渐变的配置都在Line.Fill子对象下，这是Interop封装和UI操作路径不一致导致的常见误区
• 配置渐变前不要调用Line.Fill.Solid()方法，该方法会将边框填充重置为纯色模式，覆盖渐变配置
• 若渐变效果不显示，优先检查Line.Visible是否设为msoTrue、Line.Weight是否设置了足够大的数值，1像素以下的边框渐变肉眼很难识别
• 渐变样式、光圈位置的参数规则和形状填充的渐变参数完全一致，可直接复用形状填充渐变的调试经验

内容的提问来源于stack exchange，提问作者Rupesh Bhurke