Shading 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义底纹类。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 w：shd。

public class Shading : DocumentFormat.OpenXml.OpenXmlLeafElement

type Shading = class
    inherit OpenXmlLeafElement

Public Class Shading
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

Shading

注解

[ISO/IEC 29500-1 第 1 版]

shd (段落底纹)

此元素指定应用于段落内容的底纹。

此底纹由三个组件组成：

• 背景色

• (可选) 模式

• (可选的) 图案颜色

通过设置段落后面的背景色，然后使用图案提供的蒙板在该背景上应用图案颜色，从而应用生成的底纹。

如果在给定段落中省略此元素，则其值由先前在样式层次结构 (的任何级别设置确定，即) 上一个设置保持不变。 如果从未在样式层次结构中指定此设置，则不应应用任何段落底纹。

[示例：考虑一个段落，该段落的背景必须包含主题颜色 强调主题3 ，主题颜色 强调文字6 叠加使用 20% 填充图案。 使用以下 WordprocessingML 指定此要求：

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" />   
</w:pPr>  

生成的段落使用由 pct20 图案掩码指定的前景图案颜色 accent6 下的背景色强调文字 3。 示例结束]

父元素
pPr (§17.3.1.26) ;pPr (§17.3.1.25) ;pPr (§17.7.5.2) ;pPr (§17.7.6.1) ;pPr (§17.9.23) ;pPr (§17.7.8.2)

此元素的内容模型由 §17.3.5 中的常见着色属性定义定义。

[ISO/IEC 29500-1 第 1 版]

shd (Run Shading)

与段落底纹一样，此元素指定应用于运行内容的底纹。

此底纹由三个组件组成：

• 背景色

• (可选) 模式

• (可选的) 图案颜色

通过设置段落后面的背景色，然后使用图案提供的蒙板在该背景上应用图案颜色，从而应用生成的底纹。

如果不存在此元素，则默认值为保留样式 层次结构中上一级别应用的格式。 如果从未在样式层次结构中应用此元素，则运行着色不应应用于此运行的内容。

[示例：考虑一个运行，该运行必须具有由主题颜色主题颜色 强调文字 6 组成的背景，该主题颜色 文本 2 覆盖了 20% 填充图案。 使用以下 WordprocessingML 指定此要求：

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="text2" w:themeFill="accent6" />   
</w:pPr>  

生成的运行使用由 pct20 图案掩码指定的前景图案颜色 text2 下的背景色强调文字 6。 示例结束]

父元素
rPr (§17.3.1.29) ;rPr (§17.3.1.30) ;rPr (§17.5.2.28) ;rPr (§17.9.25) ;rPr (§17.7.9.1) ;rPr (§17.7.5.4) ;rPr (§17.3.2.28) ;rPr (§17.5.2.27) ;rPr (§17.7.6.2) ;rPr (§17.3.2.27)

此元素的内容模型由 §17.3.5 中的常见着色属性定义定义。

[ISO/IEC 29500-1 第 1 版]

shd (表底纹异常)

此元素指定底纹，该底纹应作为一组表级属性异常的一部分应用于当前行中的所有单元格。 与段落底纹类似，此底纹应应用于制表内容，而不管是否存在文本 -- 与单元格底纹不同，表格底纹应包括任何单元格填充。 此属性应被此行中的任何单元格上的任何单元格级底纹取代 (§17.4.33) 。

此底纹由三个组件组成：

• 背景色

• (可选) 模式

• (可选的) 图案颜色

通过设置段落后面的背景色，然后使用图案提供的蒙板在该背景上应用图案颜色，从而应用生成的底纹。

如果省略此元素，则单元格底纹应由当前表的表级单元格底纹设置 (§17.4.32) 确定。

[示例：考虑一个表，其中最后两行具有一组表级属性例外，为它们提供 背景 2 主题颜色底纹，如下所示：

可以使用以下 WordprocessingML 指定此表级底纹异常：

<w:tblPrEx>  
  <w:jc w:val="left" />   
  <w:shd w:val="clear" w:color="auto" w:fill="EEECE1" w:themeFill="background2" />   
</w:tblPrEx>  

shd 元素使用背景主题颜色 background2 指定具有清晰图案的单元格底纹。 示例结束]

父元素
tblPrEx (§17.4.61) ;tblPrEx (§17.4.62)

此元素的内容模型由 §17.3.5 中的常见着色属性定义定义。

[ISO/IEC 29500-1 第 1 版]

shd (表底纹)

此元素指定底纹，该底纹应应用于当前表的范围。 与段落底纹类似，此底纹应应用于制表内容，而不管是否存在文本 -- 与单元格底纹不同，表格底纹应包括任何单元格填充。 此属性应通过任何表级属性异常（ (§17.4.31) ）被任何单元格级底纹取代;或此行中的任何单元格 (§17.4.33) 。

此底纹由三个组件组成：

• 背景色

• (可选) 模式

• (可选的) 图案颜色

通过设置段落后面的背景色，然后使用图案提供的蒙板在该背景上应用图案颜色，从而应用生成的底纹。

如果省略此元素，则此表中的单元格应具有关联的表格样式指定的底纹。 如果未在样式层次结构中指定单元格底纹，则此表中的单元格不应具有任何单元格底纹 (即它们应是透明的) 。

[示例：考虑一个表，其中第一行中的第一个单元格具有单元格级别的红色底纹，如下所示：

R1C1

R1C2

R2C1

R2C2

可以使用以下 WordprocessingML 指定此表级单元格底纹：

<w:tbl>  
  <w:tblPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000"/>  
    …  </w:tblPr>  
  …</w:tbl>  

shd 元素使用背景色 FF0000 (红色) 指定具有清晰图案的单元格底纹。 示例结束]

父元素
tblPr (§17.4.60) ;tblPr (§17.4.59) ;tblPr (§17.7.6.4) ;tblPr (§17.7.6.3)

此元素的内容模型由 §17.3.5 中的常见着色属性定义定义。

[ISO/IEC 29500-1 第 1 版]

shd (表格单元格底纹)

此元素指定应应用于当前表单元格范围的底纹。 与段落底纹类似，无论是否存在文本，此底纹应应用于单元格内容，以及单元格边框。

此底纹由三个组件组成：

• 背景色

• (可选) 模式

• (可选的) 图案颜色

通过设置段落后面的背景色，然后使用图案提供的蒙板在该背景上应用图案颜色，从而应用生成的底纹。

如果省略此元素，则单元格底纹应由当前表的表级或表级异常单元格底纹设置 (§17.4.31;§17.4.32) 确定。

[示例：考虑一个表，其中第一行中的第一个单元格具有单元格级别的红色底纹，如下所示：

R1C1

R1C2

R2C1

R2C2

将使用以下 WordprocessingML 指定此单元格底纹：

<w:tc>  
  <w:tcPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000" />  
  </w:tcPr>  
</w:tc>  

shd 元素使用背景色 FF0000 (红色) 指定具有清晰图案的单元格底纹。 示例结束]

父元素
tcPr (§17.7.6.8) ;tcPr (§17.7.6.9) ;tcPr (§17.4.70) ;tcPr (§17.4.71)

此元素的内容模型由 §17.3.5 中的常见着色属性定义定义。

ISO/IEC29500：2008。

构造函数

Shading()

初始化着色类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Color	底纹图案颜色 表示架构中的以下属性：w：color
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
Fill	底纹背景色 表示架构中的以下属性：w：fill
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
ThemeColor	底纹图案主题颜色 表示架构中的以下属性：w：themeColor
ThemeFill	底纹背景主题颜色 表示架构中的以下属性：w：themeFill
ThemeFillShade	底纹背景主题颜色底纹 表示架构中的以下属性：w：themeFillShade
ThemeFillTint	底纹背景主题颜色色调 表示架构中的以下属性：w：themeFillTint
ThemeShade	底纹图案主题颜色底纹 表示架构中的以下属性：w：themeShade
ThemeTint	底纹图案主题颜色色调 表示架构中的以下属性：w：themeTint
Val	底纹图案 表示架构中的以下属性：w：val
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素列表中指定索引处插入指定的元素。 (继承自 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlLeafElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	从当前元素的子元素列表中删除指定的子元素。 (继承自 OpenXmlElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将子元素替换为当前元素的子元素列表中的另一个子元素。 (继承自 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	定义底纹类。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 w：shd。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)