Page.DropConnected-Methode (Visio)
Erstellt ein neues Shape-Objekt auf dem Zeichenblatt, platziert das neue Shape relativ zum angegebenen vorhandenen Ziel-Shape und fügt dem neuen Shape einen Verbinder aus dem vorhandenen Shape 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 | Shape | 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
Shape
Hinweise
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.