Page.DropContainer-Methode (Visio)

Artikel
04/07/2023

Erstellt ein neues Container-Shape-Objekt auf der Seite, platziert den Container um die angegebenen Ziel-Shapes und fügt die Ziel-Shapes dem Container hinzu. Gibt das Container-Shape zurück.

Syntax

Ausdruck. DropContainer( _ObjectToDrop_ , _TargetShapes_ )

Ausdruck Eine Variable, die ein Page-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
ObjectToDrop	Erforderlich	[UNBEKANNT]	Das Container-Shape, das der Seite hinzugefügt werden soll. Kann ein Master-, MasterShortcut-, Shape- oder IDataObject-Objekt sein.
TargetShapes	Erforderlich	[UNBEKANNT]	Die Shapes, die der Container enthalten soll. Kann ein Shape- oder Selection-Objekt sein. Die Shapes oder die Auswahl müssen sich bereits auf dem Zeichenblatt befinden.

Rückgabewert

Shape

Hinweise

Um ein Master-Objekt für den ObjectToDrop-Parameter zu übergeben, verwenden Sie die Documents.OpenEx-Methode und die Application.GetBuiltInStencilFile-Methode und übergeben sie visBuiltInStencilContainers, um die ausgeblendete integrierte Containerschablone zu öffnen. Verwenden Sie dann die Masters.ItemU-Eigenschaft , um den gewünschten Container aus der Schablone abzurufen.

Ein IDataObject, das Sie für ObjectToDrop übergeben, muss von Microsoft Visio bereitgestellt werden und muss sich in demselben Prozessbereich wie Visio befinden.

Wenn es sich bei ObjectToDrop nicht um ein Visio-Objekt oder nicht um einen Container handelt, gibt Visio den Fehler "Ungültiger Parameter" aus. Wenn der übergebene Wert ein Shape ist, das nicht dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.

Wenn der Parameter TargetShapesauf Nothing festgelegt ist, platziert Visio das Container-Shape in der Mitte der Seite ohne Ziel-Shapes. Wenn die angegebenen Ziel-Shapes keine Mitglieder der obersten Ebene der Seite sind, gibt Visio den Fehler "Ungültiger Parameter" aus.

Die DropContainer-Methode entspricht dem Befehl Container einfügen auf der Visio-Benutzeroberfläche. (Klicken Sie auf der Registerkarte Einfügen auf Container.)

Beispiel

Im folgenden beispiel für Visual Basic for Applications (VBA) wird gezeigt, wie Sie die DropContainer-Methode verwenden, um der aktiven Seite einen Container aus der ausgeblendeten, integrierten Containerschablone hinzuzufügen, um die ausgewählte Form oder Shapes zu enthalten. Stellen Sie vor dem Ausführen dieses Makros sicher, dass auf dem aktiven Zeichenblatt eine ausgewählte Form (oder eine Auswahl von Shapes) vorhanden ist.

Public Sub DropContainer_Example()

    Dim vsoDocument As Visio.Document
    Set vsoDocument = Application.Documents.OpenEx(Application.GetBuiltInStencilFile(visBuiltInStencilContainers, visMSUS), visOpenHidden)
    Application.ActivePage.DropContainer vsoDocument.Masters.ItemU("Container 1"), Application.ActiveWindow.Selection
    vsoDocument.Close
    
End Sub

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.

Freigeben über