ClipPath 类

定义

命名空间:

DocumentFormat.OpenXml.Vml.Office

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

形状剪辑路径。

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

将对象序列化为 xml 时，其限定名称为 o：clippath。

public class ClipPath : DocumentFormat.OpenXml.OpenXmlLeafElement

type ClipPath = class
    inherit OpenXmlLeafElement

Public Class ClipPath
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

ClipPath

注解

[ISO/IEC 29500-1 第 1 版]

剪辑路径 (形状剪辑路径)

此元素指定形状的剪裁多边形的路径。

[示例：

<v:rect … wrapcoords="-207 -433 -207 21925 21807 21925 21807 -433 -207 -433" o:clip="t" o:cliptowrap="t">  
  <o:clippath o:v="m-207,-433r,22358l21807,21925r,-22358l-207,-433xe"/>  
</v:rect>  

示例结束]

父元素
arc (§14.1.2.1) ;背景 (第 1 部分§17.2.1) ;曲线 (§14.1.2.3) ;group (§14.1.2.7) ;hdrShapeDefaults (§9.7.2.1) ;image (§14.1.2.10) ;行 (§14.1.2.12) ;object (Part 1， §17.3.3.19) ;oval (§14.1.2.13) ;pict (§9.2.2.2) ;pict (§9.5.1) ;polyline (§14.1.2.15) ;rect (§14.1.2.16) ;roundrect (§14.1.2.17) ;shape (§14.1.2.19) ;shapeDefaults (§9.7.2.2) ;shapetype (§14.1.2.20)

属性

说明

v (路径定义)

指定包含定义形状路径的命令的字符串。 此值由后跟零个或多个参数的命令组成。 默认值为无值。 以下规则适用于路径字符串： - 每个命令的逗号或空格分隔参数。 “m 0,0”和“m0 0”均可接受。 - 使用逗号省略的参数被视为值为零。 因此，“c 10,10,0,0,0,25,13”和“c 10,10,,,25,13”等效。 - 还允许参数化路径。 在这种情况下，形状还应具有一个 formulas 元素 (§14.1.2.6) ，其中包含使用 @ 符号后跟公式编号替换到路径中的公式列表。 形状的 adj 属性包含这些公式的输入参数。 例如，“移动到 @1@4”。 公式的计算值将替换为适当的位置。 @ 也用作分隔符。 下面提供了允许的命令。 星号 (*) 表示允许重复该命令。 对于 qb 命令，还允许重复控制点参数。 命令 名称 参数 说明 m moveto 2 在给定 (x，y) 坐标处启动新的子路径。 l lineto 2* 绘制一条从当前点到给定 (x，y) 坐标的直线，该坐标将成为新的当前点。 指定多个坐标对会形成折线。 c curveto 6* 绘制从当前点到最后两个参数给出的坐标的立方贝塞尔曲线。 控制点由前四个参数提供。 x 关闭 0 通过绘制从当前点到原始移动到点的直线来关闭当前子路径。 e end 0 结束当前子路径集。 填充 (结尾) 分隔的给定子路径集。 后续子路径集是独立填充的，并叠加到现有子路径上。 t rmoveto 2* 在相对于当前点的坐标处启动新的子路径，cp (cpx+x、cpy+y) 。 r rlineto 2* 从当前点到给定相对坐标绘制一条直线， (cpx+x、cpy+y) 。 V rcurveto 6* 使用相对于当前点的给定坐标的立方贝塞尔曲线。 Nf nofill 0 以 e) 分隔 (当前子路径集未填充。 ns nostroke 0 (用 e) 分隔的当前子路径集不会划线。 Ae angleellipseto 6* 按照这些参数的说明绘制椭圆段。 直线从当前点绘制到段的起点。 参数为：center (x，y) 、size (w，h) 、start angle、end angle。 铝 angleellipse 6* 与 angleellipseto 相同，只不过有一个隐式移动到段的起点。 在 arcto 8* 将绘制椭圆段，该段从开始半径向量定义的角度开始，以结束向量定义的角度结束。 从当前点绘制到弧线起点的直线。弧线始终以逆时针方向绘制。 参数为：left、top、right、bottom、start (x，y) 、end (x，y) 。 前四个值定义椭圆的边界框。 最后四个定义两个径向矢量。 ar 弧 8* 与 arcto 相同，只是有一个隐式移动到弧线的起点。 洼 clockwisearcto 8* 与 arcto 相同，但弧线按顺时针方向绘制。 水利 clockwisearc 8* 与弧线相同，但弧线按顺时针方向绘制 qx ellipticalqaudrantx 2* 从当前点绘制到给定终点的四分之一椭圆。 椭圆线段最初与 x 轴平行的直线相切。 (即段从水平) 开始。 参数为：end (x，y) 。 qy ellipticalquadranty 2* 与 ellipticalquadrantx 相同，只不过椭圆线段最初与与 y 轴平行的直线相切 (即线段从垂直) 开始。 Qb quadraticbezier 2+2* 通过控制点和终点定义一个或多个二次贝塞尔曲线。 中间 (曲线上) 点是通过连续控制点之间的内插获取的，如 OpenType 字体规范中所示。 在关闭子路径的情况下，不需要启动子路径。 在这种情况下，子路径的最后一个点定义二次贝塞尔的起点。 参数为：controlpoint (x，y) *、end (x，y) 。 此属性可能的值由 W3C XML 架构 string 数据类型定义。

[注意：此元素的内容模型 (CT_ClipPath) 的 W3C XML 架构定义位于 §A.6.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

ClipPath()

初始化 ClipPath 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
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)
Value	路径定义 表示架构中的以下属性：o：v
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 时，其限定名称为 o：clippath。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)