ConnectionSite Class

Shape Connection Site.When the object is serialized out as xml, its qualified name is a:cxn.

Inheritance Hierarchy

System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.ConnectionSite

Namespace: DocumentFormat.OpenXml.Drawing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'宣言
<ChildElementInfoAttribute(GetType(Position))> _
Public Class ConnectionSite _
    Inherits OpenXmlCompositeElement
'使用
Dim instance As ConnectionSite

[ChildElementInfoAttribute(typeof(Position))]
public class ConnectionSite : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

• Position <a:pos>

[ISO/IEC 29500-1 初版]

20.1.9.9 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 is maintained 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 (§20.1.9.10)

Child Elements	Subclause
pos (Shape Position Coordinate)	§20.1.9.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 tries 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 (§20.1.10.1).

[Note: The W3C XML Schema definition of this element's content model (CT_ConnectionSite) is located in §A.4.1. end note]

© ISO/IEC29500: 2008. 上記の引用はマイクロソフト (またはその代理) によって英語から日本語に翻訳されたものであり、ISO はこうした翻訳に対する責任を一切負いません。

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

ConnectionSite Members

DocumentFormat.OpenXml.Drawing Namespace