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 aufgenommen 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 den Fehler 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 den Fehler Disabled zurück.
Beispiel
Im folgenden beispiel für Visual Basic for Applications (VBA) wird veranschaulicht, wie Sie die DropIntoList-Methode verwenden, um einer vorhandenen Liste auf der aktiven Seite an der ersten Position in der Liste ein neues Shape hinzuzufügen.
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.