cxn (Shape Connection Site)

This element specifies the existence of a connection site on a custom shape. A connection site allows a cxnSp to be attached to this shape. This connection will be maintined when the shape is repositioned within the document. It should be noted that this connection is placed within the shape bounding box using the transform coordinate system which is also called the shape coordinate system, as it encompasses the entire shape. The width and height for this coordinate system are specified within the ext transform element.

[Note: The transform coordinate system is different from a path coordinate system as it is per shape instead of per path within the shape. end note]

[Example: Consider the following custom geometry that has two connection sites specified. One connection is located at the bottom left of the shape and the other at the bottom right. The following DrawingML would describe such a custom geometry.

<a:xfrm>
<a:off x="3200400" y="1600200"/>
<a:ext cx="1705233" cy="679622"/>
</a:xfrm>

<a:custGeom>
<a:avLst/>
<a:gdLst/>
<a:ahLst/>
<a:cxnLst>
<a:cxn ang="0">
<a:pos x="0" y="679622"/>
</a:cxn>

<a:cxn ang="0">
<a:pos x="1705233" y="679622"/>
</a:cxn>
</a:cxnLst>

<a:rect l="0" t="0" r="0" b="0"/>
<a:pathLst>
<a:path w="2" h="2">
<a:moveTo>
<a:pt x="0" y="2"/>
</a:moveTo>

<a:lnTo>
<a:pt x="2" y="2"/>
</a:lnTo>

<a:lnTo>
<a:pt x="1" y="0"/>
</a:lnTo>

<a:close/>
</a:path>
</a:pathLst>
</a:custGeom>

end example]

Parent Elements

cxnLst (§5.1.11.10)

Child Elements	Subclause
pos (Shape Position Coordinate)	§5.1.11.17

Attributes

Description

ang (Connection Site Angle)

Specifies the incoming connector angle. This angle is the angle around the connection site that an incoming connector will try to be routed to. This allows connectors to know where the shape is in relation to the connection site and route connectors so as to avoid any overlap with the shape.

[Example: Consider a simple square. In order to not have any connectors routed over the shape, the collowing angles would be specified for their respective connection sites.

end example]

The possible values for this attribute are defined by the ST_AdjAngle simple type (§5.1.12.1).

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>