共用方式為


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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0" parTransId="9" sibTransId="5"/>

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:

<cxn modelId="10" type="presParOf" srcId="0" destId="4" srcOrd="3" destOrd="0" presId="urn:sampleLayouts/layout1"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0" parTransId="9" sibTransId="5"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>

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:

<cxn modelId="10" srcId="0" destId="4" srcOrd="3" destOrd="0"/>

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:

<cxn modelId="10" type="presParOf" srcId="0" destId="4" srcOrd="3" destOrd="0" presId="urn:sampleLayouts/layout1"/>

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.

See Also

Reference

Connection Members

DocumentFormat.OpenXml.Drawing.Diagrams Namespace