Table of contents
TOC
Collapse the table of content
Expand the table of content

Page.DropCallout Method (Visio)

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

Creates a new callout Shape object on the page near the specified target shape, and associates the callout with the target shape. Returns the callout shape.

Syntax

expression . DropCallout( ObjectToDrop , TargetShape )

expression A variable that represents a Page object.

Parameters

NameRequired/OptionalData TypeDescription
ObjectToDropRequired[UNKNOWN]The callout to add to the page. Can be a Master , MasterShortcut , Shape , or IDataObject object.
TargetShapeRequiredShapeThe existing shape with which to associate the callout.

Return Value

Shape

Remarks

If the ObjectToDrop parameter is not a Microsoft Visio object, Visio returns an Invalid Parameter error. If the value you pass is a shape that does not match the context of the method, Visio returns an Invalid Source error.

If the TargetShape paremeter is null, Visio places the callout shape at the center of the page and does not associate it with any target shapes. If the specified target shapes are not top-level members of the page, Visio returns an Invalid Parameter error.

The DropCallout method corresponds to the Insert Callout command in the Visio user interface. (On the Insert tab, click Callout.)

Example

The following Visual Basic for Applications (VBA) example shows how to use the DropCallout method to add a callout to the active page and associate it with a specific shape.

Dim vsoDocument As Visio.Document
Set vsoDocument = Application.Documents.OpenEx(Application.GetBuiltInStencilFile(visBuiltInStencilCallouts, visMSUS), visOpenHidden) 
Application.ActivePage.DropCallout vsoDocument.Masters.ItemU("Text callout"), vsoTargetShape
vsoDocument.Close
© 2017 Microsoft