Master.Drop method (Visio)

Creates one or more new Shape objects by dropping an object onto a receiving object such as a master, drawing page, shape, or group.

Syntax

expression.Drop (ObjectToDrop, xPos, yPos)

expression A variable that represents a Master object.

Parameters

Name Required/Optional Data type Description
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.

Return value

Shape

Remarks

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.

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.