Table of contents
Collapse the table of content
Expand the table of content

ConnectorFormat.BeginConnectedShape Property (Publisher)

office 365 dev account|Last Updated: 8/24/2017
3 Contributors

Returns a Shape object that represents the shape to which the beginning of the specified connector is attached.


expression. BeginConnectedShape

_expression_A variable that represents a ConnectorFormat object.

Return Value



If the beginning of the specified connector isn't attached to a shape, an error occurs.

Use the EndConnectedShape property to return the shape attached to the end of a connector.


This example assumes that the first page in the active publication already contains two shapes attached by a connector named Conn1To2. The code adds a rectangle and a connector to the first page. The beginning of the new connector will be attached to the same connection site as the beginning of the connector named Conn1To2, and the end of the new connector will be attached to connection site one on the new rectangle.

Dim shpNew As Shape 
Dim intSite As Integer 
Dim shpOld As Shape 

With ActiveDocument.Pages(1).Shapes 

 ' Add new rectangle. 
 Set shpNew = .AddShape(Type:=msoShapeRectangle, _ 
 Left:=450, Top:=190, Width:=200, Height:=100) 

 ' Add new connector. 
 .AddConnector(Type:=msoConnectorCurve, _ 
 BeginX:=0, BeginY:=0, EndX:=10, EndY:=10) _ 
 .Name = "Conn1To3" 

 ' Get connection site number of old shape, and set 
 ' reference to old shape. 
 With .Item("Conn1To2").ConnectorFormat 
 intSite = .BeginConnectionSite 
 Set shpOld = .BeginConnectedShape 
 End With 

 ' Connect new connector to old shape and new rectangle. 
 With .Item("Conn1To3").ConnectorFormat 
 .BeginConnect ConnectedShape:=shpOld, _ 
 .EndConnect ConnectedShape:=shpNew, _ 
 End With 
End With 
© 2018 Microsoft