Page. DropConnected-Methode (Visio)Page.DropConnected method (Visio)

Erstellt ein neues Shape -Objekt auf der Seite, platziert die neue Form relativ zur angegebenen vorhandenen Zielform und fügt der neuen Form einen Verbinder aus dem vorhandenen Shape hinzu.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. Gibt das neu erstellte Shape zurück.Returns the newly created shape.

SyntaxSyntax

Ausdruck.expression. DropConnected( _ObjectToDrop_ , _TargetShape_ , _PlacementDir_ , _[Connector]_ )

Ausdruck Eine Variable, die ein Page -Objekt darstellt.expression A variable that represents a Page object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ObjectToDropObjectToDrop ErforderlichRequired Unbekannt[UNKNOWN] Das Shape, das der Seite hinzugefügt werden soll.The shape to add to the page. Kann eine Master-, MasterShortcut-, Shape-oder ein IDataObject -Objekt sein.Can be a Master, MasterShortcut, Shape, or an IDataObject object.
TargetShapeTargetShape ErforderlichRequired ShapeShape Das vorhandene Shape, von dem aus die Ausrichtung, die Abstandsermittlung und die Verbindung erfolgen sollThe existing shape from which to align, space, and connect.
PlacementDirPlacementDir ErforderlichRequired VisAutoConnectDirVisAutoConnectDir Die Richtung von TargetShape , in der _ObjectToDrop_platziert werden soll.The direction from TargetShape in which to place ObjectToDrop.
ConnectorConnector OptionalOptional Unbekannt[UNKNOWN] Der zu verwendende Verbinder.The connector to use. Kann eine Master-, MasterShortcut-, Shape-oder ein IDataObject -Objekt sein.Can be a Master, MasterShortcut, Shape, or an IDataObject object.

RückgabewertReturn value

ShapeShape

BemerkungenRemarks

Der ObjectToDrop -Parameter muss ein Objekt sein, das auf eine zweidimensionale (2D) Form verweist.The ObjectToDrop parameter must be an object that references a two-dimensional (2D) shape. Wenn Sie eine Auswahl von Shapes übergeben, die von einem IDataObject-Objekt repräsentiert wird, verwendet Visio nur das erste dieser Shapes.If you pass a selection of shapes represented by an IDataObject object, Visio uses only the first of those shapes. Wenn es sich bei ObjectToDrop nicht um ein gültiges Visio-Objekt handelt, gibt Visio den Fehler "Ungültiger Parameter" aus.If ObjectToDrop is not a valid Visio object, Visio returns an Invalid Parameter error. Wenn ObjectToDrop kein Shape ist, das dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.If ObjectToDrop is not a shape that matches the context of the method, Visio returns an Invalid Source error.

Der TargetShape -Parameter muss ein 2D-Shape auf oberster Ebene auf der Seite sein.The TargetShape parameter must be a 2D top-level shape on the page. Wenn TargetShape ungültig ist, gibt Visio den Fehler "Ungültige Quelle" aus.If TargetShape is invalid, Visio returns an Invalid Source error.

Der Wert des PlacementDir -Parameters muss eine der VisAutoConnectDir -Konstanten sein.The PlacementDir parameter value must be one of the VisAutoConnectDir constants. Wenn Sie visAutoConnectDirNone für PlacementDir übergeben, platziert Visio die Form an einer Standardposition (0,0) und verbindet Sie dann; das Shape wird nicht in Relation zum Ziel positioniert.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.

Der Connector -Parameter muss ein Objekt sein, das auf eine eindimensionale (1D) routingfähige Form verweist.The Connector parameter must be an object that references a one-dimensional (1D) routable shape. Wenn Sie eine Auswahl von Shapes übergeben, die von einem IDataObject-Objekt repräsentiert wird, verwendet Visio nur das erste dieser Shapes.If you pass a selection of shapes represented by an IDataObject object, Visio uses only the first of those shapes. Wenn es sich bei Connector nicht um ein gültiges Visio-Objekt handelt, gibt Visio den Fehler "Ungültiger Parameter" aus.If Connector is not a valid Visio object, Visio returns an Invalid Parameter error. Wenn Connector kein Shape ist, das dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.If Connector is not a shape that matches the context of the method, Visio returns an Invalid Source error.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.