|Visio Automation Reference|
Version Added: Visio 2.0
expression.Drop(ObjectToDrop, xPos, yPos)
expression A variable that represents a Page object.
|ObjectToDrop||Required||[UNKNOWN]||The object or selection to drop. 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.|
|xPos||Required||Double||The x-coordinate at which to place the center of the shape's width or PinX.|
|yPos||Required||Double||The y-coordinate at which to place the center of the shape's height or PinY.|
Using the Drop method is similar to moving a shape with the mouse. The object dropped (ObjectToDrop) can be a master or a shape on the drawing page.
To add a shape to a group or on a drawing page, apply the Drop method to a Shape or Page object, respectively. 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. When applying this method to a Shape object, make sure that the Shape object represents a group.
If ObjectToDrop is a Master, the pin of the master is dropped at the specified coordinates. A master's pin is often, but not necessarily, at its center of rotation.
The following example shows how to use the Drop method to drop shapes onto Page and Shape objects.
|Visual Basic for Applications|