PresetTextWrap 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
预设文本扭曲。
此类在 Office 2007 及更高版本中可用。
当对象序列化为 xml 时，其限定名称为 a：prstTxWarp。
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(10, "prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElementpublic class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr(10, "prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))]
public class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class PresetTextWrap : DocumentFormat.OpenXml.OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(10, "prstTxWarp")>]
type PresetTextWrap = class
inherit OpenXmlCompositeElementtype PresetTextWrap = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr(10, "prstTxWarp")>]
type PresetTextWrap = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")>]
type PresetTextWrap = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")>]
type PresetTextWrap = class
inherit TypedOpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))>]
type PresetTextWrap = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type PresetTextWrap = class
inherit OpenXmlCompositeElementPublic Class PresetTextWrap
Inherits OpenXmlCompositeElementPublic Class PresetTextWrap
Inherits TypedOpenXmlCompositeElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
prstTxWarp (Preset Text Warp)
此元素指定何时应使用预设几何形状来转换一段文本。 此操作正式称为文本扭曲。 生成应用程序应能够呈现ST_TextShapeType列表中枚举的所有预设几何图形。
[示例：请考虑用户希望通过扭曲文本的形状来重音。 为此，从ST_TextShapeType列表中选择预设形状，并将其应用于整个文本正文。
<p:sp>
<p:txBody>
<a:bodyPr wrap="none" rtlCol="0">
<a:prstTxWarp prst="textInflate">
</a:prstTxWarp>
<a:spAutoFit/>
</a:bodyPr>
<a:lstStyle/>
<a:p>
… <a:t>Sample Text</a:t>
… </a:p>
</p:txBody>
</p:sp>
8cf1df7f-8848-4e4c-a167-ed264eec5f58
现在已应用了膨胀文本扭曲的结果文本如上所示。 示例结束]
使用下面的ST_TextShapeType列表下列出的任何预设，可以通过以下步骤对 DrawingML 文本的运行应用文本扭曲。
如果查看文件格式中的任何文本扭曲，你会发现每个文本扭曲由两个路径组成。 这对应于第一个) 指定路径 (顶部路径， (第二个指定) 的底部路径。 现在，顶部路径和底部路径表示文本需要扭曲到的上行和底线。 这是按以下方式完成的：
计算不需要的文本所在的矩形。 (文本周围尽可能紧的矩形，除了“空格字符”)
采用每个二次和三次贝塞尔曲线，这些曲线用于计算原始字符，并通过以下方法更改其终点和控制点...
沿原始文本矩形水平移动垂直线，并查找给定终点或控制点所在的水平百分比。 实例) 中间的 (.5
现在，请对此点执行相同的垂直操作。 查找此点所在的垂直百分比，此文本矩形的顶部和底部是各自的顶部和底部边界。 (分别) 0.0 和 1.0
现在，我们已获得贝塞尔公式中给定点的百分比，我们可以将其映射到扭曲文本环境中的新点。
返回到文件格式中指定的顶部和底部路径，我们可以采用这些路径并将其平展为直弧， (顶部和底部可能是不同的长度)
在它们为直之后，我们可以同时水平测量它们，以查找在原始文本矩形中找到的相同百分点。 (0.5 假设)
因此，我们测量 50% 沿顶部路径和 50% 沿底部路径，将路径放回其原始弯曲形状。
有了这两个点后，我们可以在它们之间画一条线，作为原始文本矩形中的垂直线 [注意：这可能不是真正的垂直，因为顶部的 50% 并不总是与底部的 50% 对齐。 注释结束]
采用此新行，然后从上到下遵循从步骤 4 获取的垂直百分比量。
然后，这是应用于代替原始文本矩形中旧点的新点。
然后，我们继续对文本正文中的每个终结点和控制点执行相同的步骤。 (仅应用于整个文本正文)
[注意：Horizxontal 百分比从 0.0 开始，然后继续为 1.0，从左到右。 垂直百分比从 0.0 开始，继续为 1.0，从上到下。 注释结束]
[注意：由于这是一个形状，它确实具有形状坐标系和路径坐标系。 注释结束]
| 父元素 |
|---|
| bodyPr (§21.1.2.1.1) |
| 子元素 | 第 |
|---|---|
| avLst (形状调整值列表) | §20.1.9.5 |
[注意：此元素的内容模型 (CT_PresetTextShape) 的 W3C XML 架构定义位于 §A.4.1 中。 注释结束]
ISO/IEC29500：2008。
构造函数
| PresetTextWrap() |
初始化 PresetTextWrap 类的新实例。 |
| PresetTextWrap(IEnumerable<OpenXmlElement>) |
使用指定的子元素初始化 PresetTextWrap 类的新实例。 |
| PresetTextWrap(OpenXmlElement[]) |
使用指定的子元素初始化 PresetTextWrap 类的新实例。 |
| PresetTextWrap(String) |
从外部 XML 初始化 PresetTextWrap 类的新实例。 |
属性
| AdjustValueList |
调整值列表。 表示架构中的以下元素标记：a：avLst。 |
| ChildElements |
获取当前元素的所有子节点。 (继承自 OpenXmlElement) |
| ExtendedAttributes |
获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement) |
| Features |
IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement) |
| FirstChild |
获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement) |
| HasAttributes |
获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement) |
| HasChildren |
获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement) |
| InnerText |
获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement) |
| InnerXml |
获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement) |
| LastChild |
获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement) |
| LocalName |
预设文本扭曲。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 a：prstTxWarp。 |
| LocalName |
获取当前元素的本地名称。 (继承自 OpenXmlElement) |
| MCAttributes |
获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement) |
| NamespaceDeclarations |
获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement) |
| NamespaceUri |
获取当前元素的命名空间 URI。 (继承自 OpenXmlElement) |
| OpenXmlElementContext |
获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement) |
| OuterXml |
获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement) |
| Parent |
获取当前元素的父元素。 (继承自 OpenXmlElement) |
| Prefix |
获取当前元素的命名空间前缀。 (继承自 OpenXmlElement) |
| Preset |
预设扭曲形状 表示架构中的以下属性：prst |
| XmlQualifiedName |
获取当前元素的限定名称。 (继承自 OpenXmlElement) |
| XName |
获取当前元素的限定名称。 (继承自 OpenXmlElement) |
方法
| AddAnnotation(Object) |
将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement) |
| AddChild(OpenXmlElement, Boolean) |
如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement) |
| 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) |
将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement) |
| 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) |
在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement) |
| InsertAfterSelf<T>(T) |
在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement) |
| InsertAt<T>(T, Int32) |
在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement) |
| InsertBefore<T>(T, OpenXmlElement) |
将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement) |
| 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) |
在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement) |
| PreviousSibling() |
获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement) |
| PreviousSibling<T>() |
获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) |
| Remove() |
从其父元素中删除当前元素。 (继承自 OpenXmlElement) |
| RemoveAllChildren() |
删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement) |
| RemoveAllChildren<T>() |
删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement) |
| RemoveAnnotations(Type) |
从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement) |
| RemoveAnnotations<T>() |
从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement) |
| RemoveAttribute(String, String) |
从当前元素中删除 属性。 (继承自 OpenXmlElement) |
| RemoveChild<T>(T) |
删除指定的子元素。 (继承自 OpenXmlCompositeElement) |
| RemoveNamespaceDeclaration(String) |
删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement) |
| SetAttribute(OpenXmlAttribute) |
将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement) |
| WriteTo(XmlWriter) |
将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement) |
显式接口实现
| IEnumerable.GetEnumerator() |
预设文本扭曲。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 a：prstTxWarp。 (继承自 OpenXmlElement) |