PresetTextWrap Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Drawing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v2.20.0

Déformation de texte prédéfinie.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est 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

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

PresetTextWrap

Attributs

SchemaAttrAttribute

Remarques

[ISO/IEC 29500-1 1st Edition]

prstTxWarp (Preset Text Warp)

Cet élément spécifie quand une forme géométrique prédéfinie doit être utilisée pour transformer un morceau de texte. Cette opération est connue officiellement sous le nom de chaîne de texte. L’application de génération doit être en mesure d’afficher toutes les géométries prédéfinies énumérées dans la liste ST_TextShapeType.

[Exemple : prenons le cas où l’utilisateur souhaite mettre en valeur un morceau de texte en déflexant sa forme. Pour ce faire, une forme prédéfinie est choisie dans la liste ST_TextShapeType et appliquée à l’ensemble du corps du texte.

<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

Le texte obtenu auquel la chaîne Gonfler le texte a été appliquée est indiqué ci-dessus. Fin de l’exemple]

À l’aide de l’une des présélections répertoriées sous la liste ST_TextShapeType ci-dessous, il est possible d’appliquer une chaîne de texte à une série de texte DrawingML en procédant comme suit.

Si vous examinez l’une des déformations de texte dans le format de fichier, vous remarquez que chacune se compose de deux chemins. Cela correspond à un chemin d’accès supérieur (le premier spécifié) et à un chemin inférieur (le deuxième spécifié). Désormais, le chemin d’accès supérieur et le chemin d’accès inférieur représentent la ligne supérieure et la ligne de base vers laquelle le texte doit être déformé. Pour ce faire, procédez comme suit :

Calculez le rectangle dans lequel réside le texte non déjoué. (rectangle le plus étroit possible autour du texte, pas d’espace blanc à l’exception des « caractères d’espace »)

Prenez chacune des courbes quadratiques et cubiques de Bézier utilisées pour calculer le caractère d’origine et modifiez leurs points de terminaison et points de contrôle par la méthode suivante...

Déplacez une ligne verticale horizontalement le long du rectangle de texte d’origine et recherchez le pourcentage horizontal auquel réside un point de terminaison ou un point de contrôle donné. (.5 pour le milieu pour instance)

Maintenant, faites la même chose pour ce point verticalement. Recherchez le pourcentage vertical auquel ce point réside, le haut et le bas de ce rectangle de texte étant les limites supérieure et inférieure respectives. (0,0 et 1,0 respectivement)

Maintenant que nous avons les pourcentages pour un point donné dans une équation de Bézier, nous pouvons les mapper au nouveau point dans l’environnement de texte déformé.

Pour revenir aux chemins d’accès supérieur et inférieur spécifiés dans le format de fichier, nous pouvons les prendre et les aplatir en arc droit (haut et bas peuvent avoir des longueurs différentes)

Une fois qu’ils sont droits, nous pouvons les mesurer horizontalement pour trouver le même point de pourcentage que celui trouvé dans le rectangle de texte d’origine. (0,5 disons)

Ainsi, nous mesurons 50 % le long du chemin supérieur et 50 % le long du chemin inférieur, plaçant les chemins à leur forme courbe d’origine.

Une fois que nous avons ces deux points, nous pouvons tracer une ligne entre eux qui sert de ligne verticale dans le rectangle de texte d’origine [Remarque : Cela peut ne pas être vraiment vertical, car 50 % en haut ne sont pas toujours alignés avec 50 % en bas. Fin de la remarque]

En prenant cette nouvelle ligne, nous la suivons de haut en bas le pourcentage vertical que nous avons obtenu à l’étape 4.

Il s’agit alors du nouveau point qui doit être utilisé à la place de l’ancien point dans le rectangle de texte d’origine.

Nous continuons ensuite à effectuer ces mêmes étapes pour chacun des points de terminaison et points de contrôle dans le corps du texte. (est appliqué à un corps de texte entier uniquement)

[Remarque : Les pourcentages horizxontaux commencent à 0,0 et continuent à 1,0, de gauche à droite. Les pourcentages verticaux commencent à 0,0 et continuent à 1,0, de haut en bas. Fin de la remarque]

[Remarque : Comme il s’agit d’une forme, elle a à la fois un système de coordonnées de forme et un système de coordonnées de chemin. Fin de la remarque]

Éléments parents
bodyPr (§21.1.2.1.1)

Éléments enfants	Paragraphe
avLst (Liste des valeurs d’ajustement de forme)	§20.1.9.5

[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (CT_PresetTextShape) se trouve dans §A.4.1. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

PresetTextWrap()	Initialise une nouvelle instance de la classe PresetTextWrap.
PresetTextWrap(IEnumerable<OpenXmlElement>)	Initialise une nouvelle instance de la classe PresetTextWrap avec les éléments enfants spécifiés.
PresetTextWrap(OpenXmlElement[])	Initialise une nouvelle instance de la classe PresetTextWrap avec les éléments enfants spécifiés.
PresetTextWrap(String)	Initialise une nouvelle instance de la classe PresetTextWrap à partir du code XML externe.

Propriétés

AdjustValueList	Ajuster la liste des valeurs. Représente la balise d’élément suivante dans le schéma : a :avLst.
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement actuel. (Hérité de OpenXmlCompositeElement)
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlCompositeElement)
InnerText	Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants. (Hérité de OpenXmlCompositeElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel. (Hérité de OpenXmlCompositeElement)
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlCompositeElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
Preset	Forme de déformation prédéfinie Représente l’attribut suivant dans le schéma : prst
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma. (Hérité de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié des enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié. (Hérité de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement. (Hérité de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()

Déformation de texte prédéfinie. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est a :prstTxWarp. (Hérité de OpenXmlElement)