PresetTextWrap 类

定义

命名空间:

DocumentFormat.OpenXml.Drawing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v2.20.0

预设文本扭曲。

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

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

[DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")>]
type PresetTextWrap = class
    inherit TypedOpenXmlCompositeElement

Public Class PresetTextWrap
Inherits TypedOpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

PresetTextWrap

属性

SchemaAttrAttribute

注解

[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	获取当前元素的本地名称。 (继承自 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)