dotnet OpenXml SDK 形状填充渐变色的主题色

dotnet OpenXml SDK 形状填充渐变色的主题色

在 Office 文档的一些有趣的设计，颜色和画刷是可以继承的，这个继承包括了属性的继承。在形状填充里面使用的渐变色是可以一部分属性放在主题里面，主要找到主题里面的画刷，替换掉形状自己定义的内容，才是形状的画刷

在 Office 文档的一些有趣的设计，颜色和画刷是可以继承的，这个继承包括了属性的继承。在形状填充里面使用的渐变色是可以一部分属性放在主题里面，主要找到主题里面的画刷，替换掉形状自己定义的内容，才是形状的画刷

我拿到一份有趣的课件，从这份课件的表现上，可以找到在一个 Shape 元素里面的 ShapeProperties 定义了 GradientFill 属性

// Open

而这个 gradientFill 的 GradientStopList 的值是空

if (gradientFill.GradientStopList != null){}

通过 Office Open

从文档上看，形状属性定义里面没有 gsLst 的值

<p:spPr>	<a:xfrm>		<a:off x="611560" y="1059582"/>		<a:ext cx="2120518" cy="645160"/>	</a:xfrm>	<a:prstGeom prst="rect">		<a:avLst/>	</a:prstGeom>	<a:gradFill flip="none" rotWithShape="1">		<a:lin ang="10800000" scaled="1"/>		<a:tileRect/>	</a:gradFill></p:spPr>

也就是 a:gradFill 里面不包含 a:gsLst 的值，也就是没有 a:gs 定义颜色

这个问题是 Open 渐变色里面没有 GradientStopList 的值

而在这个形状一般都可以看到 ShapeStyle 的值，这个值里面有一个属性是 FillReference 表示样式里面的填充

<p:style>	<a:fillRef idx="2">		<a:schemeClr val="accent3"/>	</a:fillRef></p:style>

而这个样式要的属性是 idx 属性，表示属于主题的哪个样式

那么在 Open

// Slide slidevar slidePart = slide.SlidePart;FormatScheme formatScheme = slidePart?.ThemeOverridePart?.ThemeOverride?.FormatScheme;

当前，如果 Slide 拿不到就从 SlideLayoutPart 拿，再拿不到就从 SlideMasterPart 拿

然后是通过 FillReference 的 idx 从 FormatScheme 的 FillStyleList 拿到指定的元素，注意这里的 idx 使用的是从 1 开始的下标。但是 FillStyleList 的数组是 C# 的数组，下标是从 0 开始

// FillReference reference, FormatScheme formatScheme if (reference.Index != null && formatScheme != null) {  var index = (int) reference.Index.Value;  var open

而 GetThemeElement 方法的实现如下

  private static Open

此时就能拿到 Open

在 PPT 文档里面对应的是 ppt\theme\themex. 文件里面的 a:fillStyleLst 的值

<a:fmtScheme name="Office">	<a:fillStyleLst>		<a:solidFill>			<a:schemeClr val="phClr"/>		</a:solidFill>		<a:gradFill rotWithShape="1">			<a:gsLst>				<a:gs pos="0">					<a:schemeClr val="phClr">						<a:tint val="50000"/>						<a:satMod val="300000"/>					</a:schemeClr>				</a:gs>				<a:gs pos="35000">					<a:schemeClr val="phClr">						<a:tint val="37000"/>						<a:satMod val="300000"/>					</a:schemeClr>				</a:gs>				<a:gs pos="100000">					<a:schemeClr val="phClr">						<a:tint val="15000"/>						<a:satMod val="350000"/>					</a:schemeClr>				</a:gs>			</a:gsLst>			<a:lin ang="16200000" scaled="1"/>		</a:gradFill>		<!-- 忽略代码 -->

上面文档里面用的是 idx 是 2 也就是对应 a:fillStyleLst 的第二项，也就是 a:gradFill 渐变的值

此时的主题的 a:gradFill 的 a:gsLst 将会被形状的填充用到，如果形状的填充的颜色也是渐变色，如果这个渐变色没有设置 a:gsLst 的值，那么将会采用主题里面的 a:gsLst 的值。如果形状自己定义了就使用形状定义的

请看下图就知道如何获取

大部分的存在继承关系和联系的都在 Open

而渐变色的各个属性的行为请看 Office Open

官方文档请看 GradientFill Class (DocumentFormat.Open