Page.DropConnected-Methode (Visio)

Erstellt ein neues Shape-Objekt auf dem Zeichenblatt, platziert das neue Shape relativ zur angegebenen vorhandenen Zielform und fügt dem neuen Shape einen Verbinder aus der vorhandenen Form hinzu. Gibt das neu erstellte Shape zurück.

Syntax

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

Ausdruck Eine Variable, die ein Page-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
ObjectToDrop	Erforderlich	[UNBEKANNT]	Das Shape, das dem Zeichenblatt hinzugefügt werden soll. Kann ein Master-, MasterShortcut-, Shape- oder IDataObject-Objekt sein.
TargetShape	Erforderlich	Form	Das vorhandene Shape, von dem aus die Ausrichtung, die Abstandsermittlung und die Verbindung erfolgen soll
PlacementDir	Erforderlich	VisAutoConnectDir	Die Richtung von TargetShape aus gesehen, in der ObjectToDrop positioniert werden soll
Connector	Optional	[UNBEKANNT]	Der zu verwendende Verbinder. Kann ein Master-, MasterShortcut-, Shape- oder IDataObject-Objekt sein.

Rückgabewert

Form

HinwBemerkungeneise

Der ObjectToDrop-Parameter muss ein Objekt sein, das auf eine zweidimensionale (2D)-Form verweist. Wenn Sie eine Auswahl von Shapes übergeben, die von einem IDataObject-Objekt repräsentiert wird, verwendet Visio nur das erste dieser Shapes. Wenn es sich bei ObjectToDrop nicht um ein gültiges Visio-Objekt handelt, gibt Visio den Fehler "Ungültiger Parameter" aus. Wenn ObjectToDrop kein Shape ist, das dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.

Der TargetShape-Parameter muss eine 2D-Form der obersten Ebene auf dem Zeichenblatt sein. Wenn TargetShape ungültig ist, gibt Visio den Fehler "Ungültige Quelle" aus.

Der Wert des PlacementDir-Parameters muss eine der folgenden VisAutoConnectDir-Konstanten sein. Wenn Sie visAutoConnectDirNone für PlacementDir übergeben, platziert Visio das Shape an einer Standardposition (0,0) und verbindet es dann; Die Form wird nicht in Bezug auf das Ziel platziert.

Der Connector-Parameter muss ein Objekt sein, das auf eine eindimensionale (1D) routingfähige Form verweist. Wenn Sie eine Auswahl von Shapes übergeben, die von einem IDataObject-Objekt repräsentiert wird, verwendet Visio nur das erste dieser Shapes. Wenn es sich bei Connector nicht um ein gültiges Visio-Objekt handelt, gibt Visio den Fehler "Ungültiger Parameter" aus. Wenn Connector kein Shape ist, das dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.