Page.DropIntoList-Methode (Visio)

Legt das angegebene Objekt in der angegebenen Liste an der angegebenen Position ab. Gibt das soeben abgelegte Shape zurück.

Syntax

Ausdruck. DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )

Ausdruck Ein Ausdruck, der ein Page-Objekt zurückgibt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
ObjectToDrop Erforderlich IUnknown Die Quelle der Form, die in die Liste eingefügt werden soll. Kann ein Master-, Selection-, Shape- oder IDataObject-Objekt sein. Weitere Informationen finden Sie unter "Anmerkungen".
TargetList Erforderlich Shape Die Liste, in der ObjectToDrop abgelegt werden soll
lPosition Erforderlich Long Die Position in der auf 1 basierenden Liste, der das Shape hinzugefügt werden soll

Rückgabewert

Shape

Hinweise

Wenn ObjectToDrop ein Selection-Objekt ist, kann die Auswahl nur ein einziges Shape enthalten.

Wenn ObjectToDrop ein IDataObject ist, muss es mit einem lokalen Microsoft Visio-Objekt verknüpft werden, das sich in derselben Instanz wie die Seite befindet, auf der es abgelegt wird.

Visio gibt einen Fehler vom Typ "Ungültiges Ziel" zurück, wenn ObjectToDrop nicht den Kategorieanforderungen der Liste oder des Containers entspricht. Shapes können Kategorien zugewiesen werden, und Container können erforderliche und ausgeschlossene Kategorien aufweisen.

Kategorien sind vom Benutzer definierte Zeichenfolgen, die zum Kategorisieren von Shapes und damit zum Einschränken der Mitgliedschaft in einem Container verwendet werden können. Kategorien können in der Zelle User.msvShapeCategories im ShapeSheet eines Shapes definiert werden. Sie können mehrere Kategorien für ein Shape definieren, indem Sie die Kategorien durch Semikolons trennen.

Wenn ObjectToDrop kein Microsoft Visio-Objekt ist oder wenn es keine Shapes der obersten Ebene auf der Seite enthält, gibt Microsoft Visio den Fehler "Ungültiger Parameter" aus.

Wenn die ContainerProperties.LockMembership-Eigenschaft der Liste True ist, gibt Visio einen Deaktivierungsfehler zurück.

Beispiel

Im folgenden Beispiel in Visual Basic for Applications (VBA) wird gezeigt, wie mit der DropIntoList-Methode einer vorhandenen Liste auf dem aktiven Zeichenblatt an der ersten Position in der Liste eine neue Form hinzugefügt wird.

Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1

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.