Page.DropConnected Method (Visio)

Creates a new Shape object on the page, places the new shape relative to the specified existing target shape, and adds a connector from the existing shape to the new shape. Returns the newly created shape.

Version Added: Visio 2010

expression .DropConnected(ObjectToDrop, TargetShape, PlacementDir, [Connector])

expression A variable that represents a Page object.

Parameters

Name

Required/Optional

Data Type

Description

ObjectToDrop

Required

[UNKNOWN]

The shape to add to the page. Can be a Master, MasterShortcut, Shape, or an IDataObject object.

TargetShape

Required

Shape

The existing shape from which to align, space, and connect.

PlacementDir

Required

VisAutoConnectDir

The direction from TargetShape in which to place ObjectToDrop.

Connector

Optional

[UNKNOWN]

The connector to use. Can be a Master, MasterShortcut, Shape, or an IDataObject object.

Return Value

Shape

The ObjectToDrop parameter must be an object that references a two-dimensional (2-D) shape. If you pass a selection of shapes represented by an IDataObject object, Visio uses only the first of those shapes. If ObjectToDrop is not a valid Visio object, Visio returns an Invalid Parameter error. If ObjectToDrop is not a shape that matches the context of the method, Visio returns an Invalid Source error.

The TargetShape parameter must be a 2-D top-level shape on the page. If TargetShape is invalid, Visio returns an Invalid Source error.

The PlacementDir parameter value must be one of the VisAutoConnectDir constants. If you pass visAutoConnectDirNone for PlacementDir, Visio places the shape in a default location (0,0) and then connects it; the shape is not placed in relation to the target.

The Connector parameter must be an object that references a one-dimensional (1-D) routable shape. If you pass a selection of shapes represented by an IDataObject object, Visio uses only the first of those shapes. If Connector is not a valid Visio object, Visio returns an Invalid Parameter error. If Connector is not a shape that matches the context of the method, Visio returns an Invalid Source error.

Show:
© 2014 Microsoft