Drop method

Microsoft Visio Developer Reference

Drop method


Creates a new Shape or Master object by dropping an object onto a receiving object such as a stencil, drawing page, or group.

Version added



objRet = object.Drop(dropObject, x, y)


The Master or Shape object created by dropping dropObject.


Required. An expression that returns an object in the Applies to list. The object to receive dropObject.


Required. The object 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.


Required Integer. The x-coordinate at which to place the center of the shape's width or PinX.


Required Integer. The y-coordinate at which to place the center of the shape's height or PinY.


Using the Drop method is similar to dragging and dropping a shape with the mouse. The object dropped (dropObject) 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 dropObject 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.

To create a new master in a stencil, apply the Drop method to a Document object that represents a stencil (the stencil must be opened as an original or a copy rather than read-only). In this case, the x and y arguments are ignored, and the new master that is created is returned.