Partager via


ShapeGuide Classe

Définition

Guide de forme.

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 :gd.

[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(10, "gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement
[DocumentFormat.OpenXml.SchemaAttr(10, "gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement
[DocumentFormat.OpenXml.SchemaAttr("a:gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement
[DocumentFormat.OpenXml.SchemaAttr("a:gd")]
public class ShapeGuide : DocumentFormat.OpenXml.TypedOpenXmlLeafElement
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(10, "gd")>]
type ShapeGuide = class
    inherit OpenXmlLeafElement
type ShapeGuide = class
    inherit OpenXmlLeafElement
[<DocumentFormat.OpenXml.SchemaAttr(10, "gd")>]
type ShapeGuide = class
    inherit OpenXmlLeafElement
[<DocumentFormat.OpenXml.SchemaAttr("a:gd")>]
type ShapeGuide = class
    inherit OpenXmlLeafElement
[<DocumentFormat.OpenXml.SchemaAttr("a:gd")>]
type ShapeGuide = class
    inherit TypedOpenXmlLeafElement
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type ShapeGuide = class
    inherit OpenXmlLeafElement
Public Class ShapeGuide
Inherits OpenXmlLeafElement
Public Class ShapeGuide
Inherits TypedOpenXmlLeafElement
Héritage
Héritage
Attributs

Remarques

[ISO/IEC 29500-1 1st Edition]

gd (Shape Guide)

Cet élément spécifie la précense d’un repère de forme utilisé pour régir la géométrie de la forme spécifiée. Un repère de forme se compose d’une formule et d’un nom auquel le résultat de la formule est affecté. Les formules reconnues sont répertoriées avec la documentation de l’attribut fmla pour cet élément.

[Remarque : l’ordre dans lequel les repères sont spécifiés détermine l’ordre dans lequel leurs valeurs sont calculées. Par instance il n’est pas possible de spécifier un repère qui utilise un autre résultat de repère lorsque ce guide n’a pas encore été calculé. Fin de la remarque]

[Exemple : Prenons le cas où l’utilisateur souhaite spécifier un triangle dont le bord inférieur est défini non pas par des points statiques, mais à l’aide d’un paramètre variable, à savoir un repère. Considérez les diagrammes et DrawingML présentés ci-dessous. Ce premier triangle a été dessiné avec un bord inférieur égal aux 2/3 de la valeur de la hauteur de la forme. Ainsi, nous voyons dans la figure ci-dessous que le triangle semble occuper les 2/3 de l’espace vertical dans le cadre englobant de la forme.

578c5088-5a52-4f13-a3f4-8a0fb4c8ed2f

<a:xfrm>  
  <a:off x="3200400" y="1600200"/>  
  <a:ext cx="1705233" cy="679622"/>  
</a:xfrm>  
<a:custGeom>  
  <a:avLst/>   
  <a:gdLst>  
    <a:gd name="myGuide" fmla="*/ h 2 3"/>  
  </a:gdLst>  
  <a:ahLst/>  
  <a:cxnLst/>  
  <a:rect l="0" t="0" r="0" b="0"/>  
  <a:pathLst>  
    <a:path w="1705233" h="679622">  
      <a:moveTo>  
        <a:pt x="0" y="myGuide"/>  
      </a:moveTo>  
      <a:lnTo>  
        <a:pt x="1705233" y="myGuide"/>  
      </a:lnTo>  
      <a:lnTo>  
        <a:pt x="852616" y="0"/>  
      </a:lnTo>  
      <a:close/>  
    </a:path>  
  </a:pathLst>  
</a:custGeom>  

Si toutefois nous modifions le guide à moitié cela, à savoir 1/3. Ensuite, nous voyons le bord inférieur entier du triangle se déplacer pour occuper maintenant seulement 1/3 de l’espace toal dans le cadre englobant de la forme. Cela est dû au fait que les deux points inférieurs de ce triangle dépendent de ce repère pour leurs positions de coordonnées. Le triangle et le DrawingML correspondant illustrés ci-dessous illustrent ce point.

98bdf8a6-a22a-4467-9f2f-737dd98edbe1

<a:gdLst>  
  <a:gd name="myGuide" fmla="*/ h 1 3"/>  
</a:gdLst>  

Fin de l’exemple]

Éléments parents
avLst (§20.1.9.5) ; gdLst (§20.1.9.12)
Attributs Description
fmla (Formule guide de forme) Spécifie la formule utilisée pour calculer la valeur d’un repère. Chaque formule a un certain nombre d’arguments et un ensemble spécifique d’opérations à effectuer sur ces arguments afin de générer une valeur pour un repère. Au total, 17 formules différentes sont disponibles. Celles-ci sont présentées ci-dessous avec l’utilisation pour chaque définie.

('*/') - Multiplier la formule de division

Arguments : 3 (fmla="*/ x y z »)

Utilisation : « */ x y z » = ((x * y) / z) = valeur de ce guide

('+-') - Ajouter une formule de soustraction

Arguments : 3 (fmla="+- x y z »)

Utilisation : « +- x y z » = ((x + y) - z) = valeur de ce guide

('+/') - Ajouter une formule de division

Arguments : 3 (fmla="+/ x y z »)

Utilisation : « +/ x y z » = ((x + y) / z) = valeur de ce guide

(' ?:') - Formule If Else

Arguments : 3 (fmla= » ?: x y z »)

Utilisation : « ?: x y z » = if (x > 0), then y = value of this guide,

else z = valeur de ce guide

('abs') - Formule de valeur absolue

Arguments : 1 (fmla="abs x »)

Utilisation : « abs x » = if (x < 0), puis (-1) * x = valeur de ce guide

else x = valeur de ce guide

('at2') - Formule ArcTan

Arguments : 2 (fmla="at2 x y »)

Utilisation : « at2 x y » = arctan(y / x) = valeur de ce guide

('cat2') - Formule Cosinus ArcTan

Arguments : 3 (fmla="cat2 x y z »)

Utilisation : « cat2 x y z » = (x*(cos(arctan(z / y))) = valeur de ce guide

('cos') - Formule cosinus

Arguments : 2 (fmla="cos x y »)

Utilisation : « cos x y » = (x * cos( y )) = valeur de ce guide

('max') - Formule de valeur maximale

Arguments : 2 (fmla="max x y »)

Utilisation : « max x y » = if (x > y), puis x = valeur de ce guide

else y = valeur de ce guide

('min') - Formule de valeur minimale

Arguments : 2 (fmla="min x y »)

Utilisation : « min x y » = if (x < y), puis x = valeur de ce guide

else y = valeur de ce guide

('mod') - Formule modulo

Arguments : 3 (fmla="mod x y z »)

Utilisation : « mod x y z » = sqrt(x^2 + b^2 + c^2) = valeur de ce guide

('épingle') - Épingler à la formule

Arguments : 3 (fmla="pin x y z »)

Utilisation : « pin x y z » = if (y < x), then x = value of this guide

else if (y > z), then z = value of this guide

else y = valeur de ce guide

('sat2') - Formule Sine ArcTan

Arguments : 3 (fmla="sat2 x y z »)

Utilisation : « sat2 x y z » = (x*sin(arctan(z / y))) = valeur de ce guide

('sin') - Formule sinusoïdique

Arguments : 2 (fmla="sin x y »)

Utilisation : « sin x y » = (x * sin( y )) = valeur de ce guide

('sqrt') - Formule racine carrée

Arguments : 1 (fmla="sqrt x »)

Utilisation : « sqrt x » = sqrt(x) = valeur de ce guide

('tan') - Formule tangente

Arguments : 2 (fmla="tan x y »)

Utilisation : « tan x y » = (x * tan( y )) = valeur de ce guide

('val') - Formule de valeur littérale

Arguments : 1 (fmla="val x »)

Utilisation : « val x » = x = valeur de ce guide

[Remarque : les repères qui ont une formule de valeur littérale spécifiée via fmla="val x » ci-dessus ne doivent être utilisés que dans l’avLst comme valeur d’ajustement pour la forme. Toutefois, cela n’est pas strictement appliqué. Fin de la remarque]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_GeomGuideFormula (§20.1.10.27).
name (Shape Guide Name) Spécifie le nom utilisé pour faire référence à ce guide. Ce nom peut être utilisé comme une variable dans une équation. C’est-à-dire que ce nom peut être remplacé par des valeurs littérales dans d’autres repères ou la spécification du chemin de la forme.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_GeomGuideName (§20.1.10.28).

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

ISO/IEC29500 : 2008.

Constructeurs

ShapeGuide()

Initialise une nouvelle instance de la classe ShapeGuide.

Propriétés

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. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type.

(Hérité de OpenXmlElement)
Formula

Formule du guide de forme

Représente l’attribut suivant dans le schéma : fmla

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 OpenXmlLeafElement)
InnerText

Obtient ou définit les valeurs concaténées du nœud et de tous ses enfants.

(Hérité de OpenXmlElement)
InnerXml

Obtient ou définit le balisage qui représente uniquement les éléments enfants de l’élément actuel.

(Hérité de OpenXmlLeafElement)
LastChild

Obtient le dernier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type.

(Hérité de OpenXmlElement)
LocalName

Guide de forme.

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 :gd.

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)
Name

Nom du repère de forme

Représente l’attribut suivant dans le schéma : name

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)
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)
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 OpenXmlElement)
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 OpenXmlElement)
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é dans la liste des éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
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 OpenXmlElement)
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 éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
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 OpenXmlLeafElement)
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é de la liste des éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
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 un élément enfant par un autre élément enfant dans la liste d’éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
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()

Guide de forme.

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 :gd.

(Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()

Retourne un énumérateur qui itère au sein de la collection enfant.

(Hérité de OpenXmlElement)

S’applique à