Shape.RerouteConnections Method

Reroutes connectors so that they take the shortest possible path between the shapes they connect. To do this, the RerouteConnections method may detach the ends of a connector and reattach them to different connecting sites on the connected shapes.

Syntax

expression.RerouteConnections

expression   A variable that represents a Shape object.

Remarks
This method reroutes all connectors attached to the specified shape; if the specified shape is a connector, it is rerouted.

Example

This example adds two rectangles to the first page in the active publication and connects them with a curved connector. Note that the RerouteConnections method overrides the values you supply for the ConnectionSite arguments used with the BeginConnect and EndConnect methods.

  Dim shpRect1 As Shape
Dim shpRect2 As Shape
With ActiveDocument.Pages(1).Shapes
' Add two new rectangles.
Set shpRect1 = .AddShape(Type:=msoShapeRectangle, _
    Left:=100, Top:=50, Width:=200, Height:=100)
Set shpRect2 = .AddShape(Type:=msoShapeRectangle, _
    Left:=300, Top:=300, Width:=200, Height:=100)

' Add a new curved connector.
With .AddConnector(Type:=msoConnectorCurve, _
        BeginX:=0, BeginY:=0, EndX:=100, EndY:=100) _
        .ConnectorFormat

    ' Connect the new connector to the two rectangles.
    .BeginConnect ConnectedShape:=shpRect1, ConnectionSite:=1
    .EndConnect ConnectedShape:=shpRect2, ConnectionSite:=1

    ' Reroute the connector to create the shortest path.
    .Parent.<strong class="bterm">RerouteConnections</strong>
End With

End With

See Also

• Shape Object
• Shape Object Members