Page. Drop-Methode (Visio)Page.Drop method (Visio)

Erstellt ein oder mehrere neue Shape -Objekte, indem ein Objekt auf ein Empfangs Objekt wie ein Master-Shape, eine Zeichenseite, eine Form oder eine Gruppe gelöscht wird.Creates one or more new Shape objects by dropping an object onto a receiving object such as a master, drawing page, shape, or group.

SyntaxSyntax

Ausdruck. Drop (ObjectToDrop, xPos, yPos)expression.Drop (ObjectToDrop, xPos, yPos)

Ausdruck Eine Variable, die ein Page -Objekt darstellt.expression A variable that represents a Page object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ObjectToDropObjectToDrop ErforderlichRequired Unbekannt[UNKNOWN] Das abzulegende Objekt oder die abzulegende Auswahl.The object or selection to drop. Dies ist zwar normalerweise ein Visio-Objekt wie ein Master-, Shape-oder Selection -Objekt, es kann jedoch ein beliebiges OLE-Objekt sein, das eine IDataObject -Schnittstelle bereitstellt.While this is typically a Visio object such as a Master, Shape, or Selection object, it can be any OLE object that provides an IDataObject interface.
XPosxPos ErforderlichRequired DoubleDouble Die X-Koordinate, bei der der Mittelpunkt oder DrehbezX der Breite des Shapes platziert werden soll.The x-coordinate at which to place the center of the shape's width or PinX.
YPosyPos ErforderlichRequired DoubleDouble Die Y-Koordinate, bei der der Mittelpunkt oder DrehbezY der Höhe des Shapes platziert werden soll.The y-coordinate at which to place the center of the shape's height or PinY.

RückgabewertReturn value

FormShape

BemerkungenRemarks

Das Verwenden der Drop -Methode ähnelt dem Verschieben einer Form mit der Maus.Using the Drop method is similar to moving a shape with the mouse. Das abgelegte Objekt (ObjectToDrop) kann ein Master oder ein Shape auf dem Zeichenblatt sein.The object dropped (ObjectToDrop) can be a master or a shape on the drawing page.

Wenn Sie einer Gruppe oder einem Zeichenblatt ein Shape hinzufügen möchten, wenden Sie die Drop -Methode auf ein Shape -oder Page -Objekt an.To add a shape to a group or on a drawing page, apply the Drop method to a Shape or Page object, respectively. Der Mittelpunkt des Felds für Breite/Höhe des Shapes wird bei den angegebenen Koordinaten positioniert, und ein Shape-Objekt, das das erstellte Shape darstellt, wird zurückgegeben.The center of the shape's width-height box is positioned at the specified coordinates, and a Shape object that represents the shape that is created is returned. Stellen Sie beim Anwenden dieser Methode auf ein Shape-Objekt sicher, dass das Shape-Objekt eine Gruppe darstellt.When applying this method to a Shape object, make sure that the Shape object represents a group.

Wenn ObjectToDrop ein Masterist, wird die PIN des Masters an den angegebenen Koordinaten abgelegt.If ObjectToDrop is a Master, the pin of the master is dropped at the specified coordinates. Der Drehbezugspunkt eines Masters ist häufig der Mittelpunkt der Drehung, aber nicht notwendigerweise.A master's pin is often, but not necessarily, at its center of rotation.

Wenn Ihre Visual Studio Lösung den Microsoft. Office. Interop. Visio -Verweis enthält, wird diese Methode den folgenden Typen zugeordnet:If your Visual Studio solution includes the Microsoft.Office.Interop.Visio reference, this method maps to the following types:

  • Microsoft. Office. Interop. Visio. IVPage. Drop (Object, Double, Double)Microsoft.Office.Interop.Visio.IVPage.Drop(object, double, double)

BeispielExample

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der Drop -Methode Formen auf Seiten -und Shape -Objekte ablegen.The following example shows how to use the Drop method to drop shapes onto Page and Shape objects.

 
Public Sub Drop_Example() 
  
    Dim vsoShape1 As Visio.Shape  
    Dim vsoShape2 As Visio.Shape  
    Dim vsoShape3 As Visio.Shape  
    Dim vsoGroupShape As Visio.Shape  
    Dim vsoSubShape As Visio.Shape  
    Dim vsoSelection As Visio.Selection 
  
    Set vsoShape1 = ActivePage.DrawRectangle(1, 2, 2, 1)  
    Set vsoShape2 = ActivePage.DrawRectangle(1, 4, 2, 3)  
 
    'Drop a shape on the page.  
    Set vsoShape3 = ActivePage.Drop(vsoShape1, 3.5, 3.5)  
 
    'Make sure only one shape is selected to start.  
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.Select vsoShape1, visDeselectAll + visSelect  
    vsoSelection.Select vsoShape2, visSelect  
 
    'Create a group shape.  
    Set vsoGroupShape = vsoSelection.Group  
 
    'Drop a shape on the group shape to create a new subshape.  
    Set vsoSubShape = vsoGroupShape.Drop(vsoShape3, 1, 2)  
 
End Sub

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.