Connection Class
Connection.When the object is serialized out as xml, its qualified name is dgm:cxn.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.Diagrams.Connection
Namespace: DocumentFormat.OpenXml.Drawing.Diagrams
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(ExtensionList))> _
Public Class Connection _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As Connection
[ChildElementInfoAttribute(typeof(ExtensionList))]
public class Connection : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
- ExtensionList <dgm:extLst>
[ISO/IEC 29500-1 1st Edition]
21.4.3.2 cxn (Connection)
This element defines a connection between two points. A connection defines a relationship between two points in a diagram.
[Example: Consider the following example of a cxn in DiagramML:
<cxnLst>
<cxn modelId="7" srcId="0" destId="1" srcOrd="0" destOrd="0"/>
<cxn modelId="8" srcId="0" destId="2" srcOrd="1" destOrd="0"/>
<cxn modelId="9" srcId="0" destId="3" srcOrd="2" destOrd="0"/>
<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>
<cxn modelId="11" srcId="0" destId="5" srcOrd="4" destOrd="0"/>
<cxn modelId="12" srcId="0" destId="6" srcOrd="5" destOrd="0"/>
</cxnLst>
In this example we see 6 cxn elements defined within a cxnLst element (§21.4.3.3). In this example, a relationship is being defined between point 0 and every other point in the diagram. end example]
Parent Elements |
|---|
cxnLst (§21.4.3.3) |
Child Elements |
Subclause |
|---|---|
extLst (Extension List) |
§21.4.2.13 |
Attributes |
Description |
|---|---|
destId (Destination Identifier) |
The model identifier of the destination point for a connection. [Example: Consider the following example cxn within DiagramML: In this example we see the destination identifier referencing a point who's model identifier is 4. end example] The possible values for this attribute are defined by the ST_ModelId simple type (§21.4.7.43). |
destOrd (Destination Position) |
The relative position of the destination point among it's siblings. [Example: Consider the following example cxn within DiagramML: In this example we see the destination position is 0. This means that it is ranked first among its siblings if there are sibling points present. end example] The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype. |
modelId (Model Identifier) |
The unique identifier associated with this cxn. [Example: Consider the following example cxn within DiagramML: In this example we see the model identifier is 10. end example] The possible values for this attribute are defined by the ST_ModelId simple type (§21.4.7.43). |
parTransId (Parent Transition Identifier) |
The model identifier of the point representing the parent transition. [Example: One example of a parent transition can be thought of as the shape connecting two points, such as an arrow in the diagram. end example] The unique identifier associated with this cxn. [Example: Consider the following example cxn within DiagramML: In this example we see the parent transition identifier is referencing a point who's model identifier is 9. end example] The possible values for this attribute are defined by the ST_ModelId simple type (§21.4.7.43). |
presId (Presentation Identifier) |
The unique identifier of the layout associated to the cxn (only the active presentation (layout) is saved so all the presId's in the file should be the same). [Example: Consider the following example cxn within DiagramML: In this example we see the presentation identifier is urn:sampleLayouts/layout1. end example] The possible values for this attribute are defined by the W3C XML Schema string datatype. |
sibTransId (Sibling Transition Identifier) |
The model identifier of the point representing the sibling transition. [Example: An example of a sibling transition can be thought of as the shape connecting two points, such as an arrow in the diagram. end example] [Example: Consider the following example cxn within DiagramML: In this example we see the sibling transition identifier is referencing a point who's model identifier is 5. end example] The possible values for this attribute are defined by the ST_ModelId simple type (§21.4.7.43). |
srcId (Source Identifier) |
The model identifier of the source point for a connection. [Example: Consider the following example cxn within DiagramML: In this example we see the souce identifier referencing a point who's model identifier is 0. end example] The possible values for this attribute are defined by the ST_ModelId simple type (§21.4.7.43). |
srcOrd (Source Position) |
The relative position of the source point among it's siblings. [Example: Consider the following example cxn within DiagramML: In this example we see the source position is 3. This means that it is ranked third among its siblings. end example] The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype. |
type (Point Type) |
The type of point, which corresponds to a connection in this case. [Example: Consider the following example cxn within DiagramML: In this example we see the point type is defined as presParOf. end example] The possible values for this attribute are defined by the ST_CxnType simple type (§21.4.7.23). |
[Note: The W3C XML Schema definition of this element’s content model (CT_Cxn) is located in §A.5.3. end note]
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.