CustomGeometry
CustomGeometry
CustomGeometry
Class
Definition
Custom geometry. When the object is serialized out as xml, its qualified name is a:custGeom.
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustValueList))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ShapeGuideList))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.AdjustHandleList))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ConnectionSiteList))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Rectangle))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.PathList))]
public class CustomGeometry : DocumentFormat.OpenXml.OpenXmlCompositeElementtype CustomGeometry = class
inherit OpenXmlCompositeElementPublic Class CustomGeometry
Inherits OpenXmlCompositeElement- Inheritance
-
CustomGeometryCustomGeometryCustomGeometry
- Attributes
Remarks
[ISO/IEC 29500-1 1st Edition]
custGeom (Custom Geometry)
This element specifies the existence of a custom geometric shape. This shape consists of a series of lines and curves described within a creation path. In addition to this there can also be adjust values, guides, adjust handles, connection sites and an inscribed rectangle specified for this custom geometric shape.
[Example: Consider the scenario when a preset geometry does not accurately depict what must be displayed in the document. For this a custom geometry can be used to define most any 2-dimensional geometric shape. Shown below is an example of such a custom geometry.
<a:custGeom>
<a:avLst/>
<a:gdLst/>
<a:ahLst/>
<a:cxnLst/>
<a:rect l="0" t="0" r="0" b="0"/>
<a:pathLst>
<a:path w="2650602" h="1261641">
<a:moveTo>
<a:pt x="0" y="1261641"/>
</a:moveTo>
<a:lnTo>
<a:pt x="2650602" y="1261641"/>
</a:lnTo>
<a:lnTo>
<a:pt x="1226916" y="0"/>
</a:lnTo>
<a:close/>
</a:path>
</a:pathLst>
</a:custGeom>
31ad165f-ce13-4915-beaa-a307299ac0fb
The custom geometry above is drawn by first moving to a specific starting point with the moveTo element. Then a series of lnTo elements in the creation path specify the lines that make up the borders of the shape and finally a close element is used to specify the end of the creation path. The resulting shape is shown above. end example]
| Parent Elements |
|---|
| spPr (§21.2.2.197); spPr (§21.3.2.23); spPr (§21.4.3.7); spPr (§20.1.2.2.35); spPr (§20.2.2.6); spPr (§20.5.2.30); spPr (§19.3.1.44) |
| Child Elements | Subclause |
|---|---|
| ahLst (List of Shape Adjust Handles) | §20.1.9.1 |
| avLst (List of Shape Adjust Values) | §20.1.9.5 |
| cxnLst (List of Shape Connection Sites) | §20.1.9.10 |
| gdLst (List of Shape Guides) | §20.1.9.12 |
| pathLst (List of Shape Paths) | §20.1.9.16 |
| rect (Shape Text Rectangle) | §20.1.9.22 |
[Note: The W3C XML Schema definition of this element’s content model (CT_CustomGeometry2D) is located in §A.4.1. end note]
� ISO/IEC29500: 2008.
Constructors
| CustomGeometry() CustomGeometry() CustomGeometry() |
Initializes a new instance of the CustomGeometry class. |
| CustomGeometry(IEnumerable<OpenXmlElement>) CustomGeometry(IEnumerable<OpenXmlElement>) CustomGeometry(IEnumerable<OpenXmlElement>) |
Initializes a new instance of the CustomGeometry class with the specified child elements. |
| CustomGeometry(OpenXmlElement[]) CustomGeometry(OpenXmlElement[]) CustomGeometry(OpenXmlElement[]) |
Initializes a new instance of the CustomGeometry class with the specified child elements. |
| CustomGeometry(String) CustomGeometry(String) CustomGeometry(String) |
Initializes a new instance of the CustomGeometry class from outer XML. |
Properties
| AdjustHandleList AdjustHandleList AdjustHandleList |
List of Shape Adjust Handles. Represents the following element tag in the schema: a:ahLst |
| AdjustValueList AdjustValueList AdjustValueList |
Adjust Value List. Represents the following element tag in the schema: a:avLst |
| ChildElements ChildElements ChildElements |
Gets all the child nodes of the current element. (Inherited from OpenXmlElement) |
| ConnectionSiteList ConnectionSiteList ConnectionSiteList |
List of Shape Connection Sites. Represents the following element tag in the schema: a:cxnLst |
| ExtendedAttributes ExtendedAttributes ExtendedAttributes |
Gets all extended attributes (attributes not defined in the schema) of the current element. (Inherited from OpenXmlElement) |
| FirstChild FirstChild FirstChild |
Gets the first child of the current OpenXmlElement element. (Inherited from OpenXmlCompositeElement) |
| HasAttributes HasAttributes HasAttributes |
Gets a boolean value that indicates whether the current element has any attributes. (Inherited from OpenXmlElement) |
| HasChildren HasChildren HasChildren |
Gets a value that indicates whether the current element has any child elements. (Inherited from OpenXmlCompositeElement) |
| InnerText InnerText InnerText |
Gets or sets the concatenated values of the current node and all of its children. (Inherited from OpenXmlCompositeElement) |
| InnerXml InnerXml InnerXml |
Gets or sets the markup that represents only the child nodes of the current node. (Inherited from OpenXmlCompositeElement) |
| LastChild LastChild LastChild |
Gets the last child of the current OpenXmlElement element. Returns null (Nothing in Visual Basic) if there is no such OpenXmlElement element. (Inherited from OpenXmlCompositeElement) |
| LocalName LocalName LocalName |
Gets the local name of the element. |
| MCAttributes MCAttributes MCAttributes |
Sets the markup compatibility attributes. Returns null if no markup compatibility attributes are defined for the current element. (Inherited from OpenXmlElement) |
| NamespaceDeclarations NamespaceDeclarations NamespaceDeclarations |
Gets all the namespace declarations defined in the current element. Returns an empty enumerator if there is no namespace declaration. (Inherited from OpenXmlElement) |
| NamespaceUri NamespaceUri NamespaceUri |
Gets the namespace URI of the current element. (Inherited from OpenXmlElement) |
| OpenXmlElementContext OpenXmlElementContext OpenXmlElementContext |
Gets the OpenXmlEementContext of the current element. (Inherited from OpenXmlElement) |
| OuterXml OuterXml OuterXml |
Gets the markup that represents the current element and all of its child elements. (Inherited from OpenXmlElement) |
| Parent Parent Parent |
Gets the parent element of the current element. (Inherited from OpenXmlElement) |
| PathList PathList PathList |
List of Shape Paths. Represents the following element tag in the schema: a:pathLst |
| Prefix Prefix Prefix |
Gets the namespace prefix of current element. (Inherited from OpenXmlElement) |
| Rectangle Rectangle Rectangle |
Shape Text Rectangle. Represents the following element tag in the schema: a:rect |
| ShapeGuideList ShapeGuideList ShapeGuideList |
List of Shape Guides. Represents the following element tag in the schema: a:gdLst |
| XmlQualifiedName XmlQualifiedName XmlQualifiedName |
Gets the qualified name of the current element. (Inherited from OpenXmlElement) |
| XName XName XName |
Gets the qualified name of the current element. (Inherited from OpenXmlElement) |
Methods
| AddAnnotation(Object) AddAnnotation(Object) AddAnnotation(Object) |
Adds an object to the current OpenXmlElement element's list of annotations. (Inherited from OpenXmlElement) |
| AddNamespaceDeclaration(String, String) AddNamespaceDeclaration(String, String) AddNamespaceDeclaration(String, String) |
Adds a namepace declaration to the current node. (Inherited from OpenXmlElement) |
| Ancestors() Ancestors() Ancestors() |
Enumerates all of the current element's ancestors. (Inherited from OpenXmlElement) |
| Ancestors<T>() Ancestors<T>() Ancestors<T>() |
Enumerates only the current element's ancestors that have the specified type. (Inherited from OpenXmlElement) |
| Annotation(Type) Annotation(Type) Annotation(Type) |
Get the first annotation object of the specified type from the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| Annotation<T>() Annotation<T>() Annotation<T>() |
Get the first annotation object of the specified type from the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| Annotations(Type) Annotations(Type) Annotations(Type) |
Gets a collection of annotations with the specified type for the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| Annotations<T>() Annotations<T>() Annotations<T>() |
Gets a collection of annotations with the specified type for the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| Append(IEnumerable<OpenXmlElement>) Append(IEnumerable<OpenXmlElement>) Append(IEnumerable<OpenXmlElement>) |
Appends each element from a list of elements to the end of the current element's list of child elements. (Inherited from OpenXmlElement) |
| Append(OpenXmlElement[]) Append(OpenXmlElement[]) Append(OpenXmlElement[]) |
Appends each element from an array of elements to the end of the current element's list of child elements. (Inherited from OpenXmlElement) |
| AppendChild<T>(T) AppendChild<T>(T) AppendChild<T>(T) |
Appends the specified element to the end of the current element's list of child nodes. (Inherited from OpenXmlCompositeElement) |
| ClearAllAttributes() ClearAllAttributes() ClearAllAttributes() |
Clears all of the attributes, including both known attributes and extended attributes. (Inherited from OpenXmlElement) |
| Clone() Clone() Clone() |
Creates a duplicate of the current node. (Inherited from OpenXmlElement) |
| CloneNode(Boolean) CloneNode(Boolean) CloneNode(Boolean) |
Creates a duplicate of this node. |
| Descendants() Descendants() Descendants() |
Enumerates all of the current element's descendants. (Inherited from OpenXmlElement) |
| Descendants<T>() Descendants<T>() Descendants<T>() |
Enumerate all of the current element's descendants of type T. (Inherited from OpenXmlElement) |
| Elements() Elements() Elements() |
Enumerates all of the current element's children. (Inherited from OpenXmlElement) |
| Elements<T>() Elements<T>() Elements<T>() |
Enumerates only the current element's children that have the specified type. (Inherited from OpenXmlElement) |
| ElementsAfter() ElementsAfter() ElementsAfter() |
Enumerates all of the sibling elements that follow the current element and have the same parent as the current element. (Inherited from OpenXmlElement) |
| ElementsBefore() ElementsBefore() ElementsBefore() |
Enumerates all of the sibling elements that precede the current element and have the same parent as the current element. (Inherited from OpenXmlElement) |
| GetAttribute(String, String) GetAttribute(String, String) GetAttribute(String, String) |
Gets an Open XML attribute with the specified tag name and namespace URI. (Inherited from OpenXmlElement) |
| GetAttributes() GetAttributes() GetAttributes() |
Gets a list that contains a copy of all the attributes. (Inherited from OpenXmlElement) |
| GetEnumerator() GetEnumerator() GetEnumerator() |
Returns an enumerator that iterates through the child collection. (Inherited from OpenXmlElement) |
| GetFirstChild<T>() GetFirstChild<T>() GetFirstChild<T>() |
Finds the first child element in type T. (Inherited from OpenXmlElement) |
| InsertAfter<T>(T, OpenXmlElement) InsertAfter<T>(T, OpenXmlElement) InsertAfter<T>(T, OpenXmlElement) |
Inserts the specified element immediately after the specified reference element. (Inherited from OpenXmlCompositeElement) |
| InsertAfterSelf<T>(T) InsertAfterSelf<T>(T) InsertAfterSelf<T>(T) |
Inserts the specified element immediately after the current element. (Inherited from OpenXmlElement) |
| InsertAt<T>(T, Int32) InsertAt<T>(T, Int32) InsertAt<T>(T, Int32) |
Inserts the specified element at the specified index of the current element's children. (Inherited from OpenXmlCompositeElement) |
| InsertBefore<T>(T, OpenXmlElement) InsertBefore<T>(T, OpenXmlElement) InsertBefore<T>(T, OpenXmlElement) |
Inserts the specified element immediately before the specified reference element. (Inherited from OpenXmlCompositeElement) |
| InsertBeforeSelf<T>(T) InsertBeforeSelf<T>(T) InsertBeforeSelf<T>(T) |
Inserts the specified element immediately before the current element. (Inherited from OpenXmlElement) |
| IsAfter(OpenXmlElement) IsAfter(OpenXmlElement) IsAfter(OpenXmlElement) |
Determines if the current element appears after a specified element in document order. (Inherited from OpenXmlElement) |
| IsBefore(OpenXmlElement) IsBefore(OpenXmlElement) IsBefore(OpenXmlElement) |
Determines if the current element appears before a specified element in document order. (Inherited from OpenXmlElement) |
| LookupNamespace(String) LookupNamespace(String) LookupNamespace(String) |
Resolves the namespace prefix in the context of the current node. (Inherited from OpenXmlElement) |
| LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) |
Finds the corresponding prefix for a namespace uri in the current element scope. (Inherited from OpenXmlElement) |
| NextSibling() NextSibling() NextSibling() |
Gets the OpenXmlElement element that immediately follows the current OpenXmlElement element. Returns null (Nothing in Visual Basic) if there is no next OpenXmlElement element. (Inherited from OpenXmlElement) |
| NextSibling<T>() NextSibling<T>() NextSibling<T>() |
Gets the OpenXmlElement element with the specified type that follows the current OpenXmlElement element. Returns null (Nothing in Visual Basic) if there is no next OpenXmlElement. (Inherited from OpenXmlElement) |
| PrependChild<T>(T) PrependChild<T>(T) PrependChild<T>(T) |
Inserts the specified element at the beginning of the current element's list of child nodes. (Inherited from OpenXmlCompositeElement) |
| PreviousSibling() PreviousSibling() PreviousSibling() |
Gets the OpenXmlElement element that immediately precedes the current OpenXmlElement element. Returns null (Nothing in Visual Basic ) if there is no preceding OpenXmlElement element. (Inherited from OpenXmlElement) |
| PreviousSibling<T>() PreviousSibling<T>() PreviousSibling<T>() |
Gets the OpenXmlElement element with the specified type that precedes the current OpenXmlElement. Returns null (Nothing in Visual Basic) if there is no preceding OpenXmlElement element. (Inherited from OpenXmlElement) |
| Remove() Remove() Remove() |
Removes the current element from its parent. (Inherited from OpenXmlElement) |
| RemoveAllChildren() RemoveAllChildren() RemoveAllChildren() |
Removes all of the current element's child elements. (Inherited from OpenXmlCompositeElement) |
| RemoveAllChildren<T>() RemoveAllChildren<T>() RemoveAllChildren<T>() |
Remove all of the current element's child elements that are of type T. (Inherited from OpenXmlElement) |
| RemoveAnnotations(Type) RemoveAnnotations(Type) RemoveAnnotations(Type) |
Removes the annotations of the specified type from the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| RemoveAnnotations<T>() RemoveAnnotations<T>() RemoveAnnotations<T>() |
Removes the annotations with the specified type from the current OpenXmlElement element. (Inherited from OpenXmlElement) |
| RemoveAttribute(String, String) RemoveAttribute(String, String) RemoveAttribute(String, String) |
Removes the attribute from the current element. (Inherited from OpenXmlElement) |
| RemoveChild<T>(T) RemoveChild<T>(T) RemoveChild<T>(T) |
Removes the specified child element. (Inherited from OpenXmlCompositeElement) |
| RemoveNamespaceDeclaration(String) RemoveNamespaceDeclaration(String) RemoveNamespaceDeclaration(String) |
Removes the namespace declaration for the specified prefix. Removes nothing if there is no prefix. (Inherited from OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) ReplaceChild<T>(OpenXmlElement, T) ReplaceChild<T>(OpenXmlElement, T) |
Replaces one of the current element's child elements with another OpenXmlElement element. (Inherited from OpenXmlCompositeElement) |
| SetAttribute(OpenXmlAttribute) SetAttribute(OpenXmlAttribute) SetAttribute(OpenXmlAttribute) |
Sets an attribute to the specified element. If the attribute is a known attribute, the value of the attribute is set. If the attribute is an extended attribute, the 'openxmlAttribute' is added to the extended attributes list. (Inherited from OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) SetAttributes(IEnumerable<OpenXmlAttribute>) SetAttributes(IEnumerable<OpenXmlAttribute>) |
Sets a number of attributes to the element. If an attribute is a known attribute, the value of the attribute is set. If an attribute is an extended attribute, the 'openxmlAttribute' is added to the extended attributes list. (Inherited from OpenXmlElement) |
| WriteTo(XmlWriter) WriteTo(XmlWriter) WriteTo(XmlWriter) |
Saves the current node to the specified XmlWriter. (Inherited from OpenXmlElement) |
Explicit Interface Implementations
| IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() | Inherited from OpenXmlElement |