PresetTextWrap Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Drawing

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v2.20.0

Deformación de texto preestablecida.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es un: 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

Herencia

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

PresetTextWrap

Atributos

SchemaAttrAttribute

Comentarios

[ISO/IEC 29500-1 1.ª edición]

prstTxWarp (Preset Text Warp)

Este elemento especifica cuándo se debe usar una forma geométrica preestablecida para transformar un fragmento de texto. Esta operación se conoce formalmente como deformación de texto. La aplicación generadora debe poder representar todas las geometrías preestablecidas enumeradas en la lista de ST_TextShapeType.

[Ejemplo: considere el caso en el que el usuario desea acentuar un fragmento de texto deformando su forma. Para que esto ocurra, se elige una forma preestablecida de la lista de ST_TextShapeType y se aplica a todo el cuerpo del texto.

<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

El texto resultante que ahora ha tenido la deformación de texto inflado aplicado se muestra anteriormente. Fin del ejemplo]

Con cualquiera de los valores preestablecidos enumerados en la lista de ST_TextShapeType siguiente, es posible aplicar una deformación de texto a una ejecución de texto DrawingML mediante los pasos siguientes.

Si observa cualquiera de las deformaciones de texto en el formato de archivo, observará que cada una consta de dos rutas de acceso. Esto corresponde a una ruta de acceso superior (la primera especificada) y una ruta de acceso inferior (segunda especificada). Ahora la ruta de acceso superior y la ruta de acceso inferior representan la línea superior y la línea base a la que se debe deformar el texto. Esto se hace de la siguiente manera:

Calcule el rectángulo en el que reside el texto no cifrado. (rectángulo más estrecho posible alrededor del texto, sin espacio en blanco excepto para "caracteres de espacio")

Tome cada una de las curvas Bézier cuadráticas y cúbicas que se usan para calcular el carácter original y cambiar sus puntos finales y puntos de control por el método siguiente...

Mueva una línea vertical horizontalmente a lo largo del rectángulo de texto original y busque el porcentaje horizontal en el que reside un punto final o punto de control determinado. (.5 para el medio, por ejemplo)

Ahora haga lo mismo para este punto verticalmente. Busque el porcentaje vertical en el que se encuentra este punto, ya que la parte superior e inferior de este rectángulo de texto son los límites superior e inferior correspondientes. (0.0 y 1.0 respectivamente)

Ahora que tenemos los porcentajes de un punto determinado en una ecuación bézier, podemos asignarlo al nuevo punto del entorno de texto deformado.

Volviendo a las rutas de acceso superior e inferior especificadas en el formato de archivo, podemos tomarlas y aplanarlas a un arco recto (la parte superior e inferior pueden ser longitudes diferentes)

Una vez rectas, podemos medirlas horizontalmente para encontrar el mismo punto porcentual que encontramos en el rectángulo de texto original. (0.5 supongamos)

Por lo tanto, medimos un 50 % a lo largo de la ruta de acceso superior y un 50 % a lo largo de la ruta de acceso inferior, devolviendo las rutas a sus formas curvas originales.

Una vez que tengamos estos dos puntos, podemos dibujar una línea entre ellos que actúa como nuestra línea vertical en el rectángulo de texto original [Nota: Esto podría no ser realmente vertical, ya que el 50 % en la parte superior no siempre se alinea con el 50 % en la parte inferior. Fin de la nota]

Tomando esta nueva línea, la seguimos de arriba abajo la cantidad de porcentaje vertical que obtuvimos del paso 4.

Este es entonces el nuevo punto que se debe usar en lugar del punto anterior en el rectángulo de texto original.

A continuación, seguimos realizando estos mismos pasos para cada uno de los puntos finales y puntos de control dentro del cuerpo del texto. (solo se aplica a todo un cuerpo de texto)

[Nota: Los porcentajes de Horizxontal comienzan en 0,0 y continúan a 1,0, de izquierda a derecha. Los porcentajes verticales comienzan en 0,0 y continúan hasta 1,0, de arriba abajo. Fin de la nota]

[Nota: dado que se trata de una forma, tiene un sistema de coordenadas de forma y un sistema de coordenadas de ruta de acceso. Fin de la nota]

Elementos primarios
bodyPr (§21.1.2.1.1)

Elementos secundarios	Subclause
avLst (lista de valores de ajuste de formas)	§20.1.9.5

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_PresetTextShape) se encuentra en §A.4.1. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

PresetTextWrap()	Inicializa una nueva instancia de la clase PresetTextWrap.
PresetTextWrap(IEnumerable<OpenXmlElement>)	Inicializa una nueva instancia de la clase PresetTextWrap con los elementos secundarios especificados.
PresetTextWrap(OpenXmlElement[])	Inicializa una nueva instancia de la clase PresetTextWrap con los elementos secundarios especificados.
PresetTextWrap(String)	Inicializa una nueva instancia de la clase PresetTextWrap a partir de XML externo.

Propiedades

AdjustValueList	Ajustar lista de valores. Representa la siguiente etiqueta de elemento en el esquema: a:avLst.
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement actual. (Heredado de OpenXmlCompositeElement)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlCompositeElement)
InnerText	Obtiene o establece los valores concatenados del nodo actual y todos sus elementos secundarios. (Heredado de OpenXmlCompositeElement)
InnerXml	Obtiene o establece el marcado que representa solo los nodos secundarios del nodo actual. (Heredado de OpenXmlCompositeElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlCompositeElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
Preset	Forma de deformación preestablecida Representa el atributo siguiente en el esquema: prst
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Agrega el elemento especificado al elemento si es un elemento secundario conocido. Esto agrega el elemento en la ubicación correcta según el esquema. (Heredado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado de los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado. (Heredado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza uno de los elementos secundarios del elemento actual por otro elemento OpenXmlElement. (Heredado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()

Deformación de texto preestablecida. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es un: prstTxWarp. (Heredado de OpenXmlElement)