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

Erstellt ein neues Legenden- Shape -Objekt auf der Seite in der Nähe des angegebenen Ziel-Shapes und ordnet die Legende dem Ziel-Shape zu.Creates a new callout Shape object on the page near the specified target shape, and associates the callout with the target shape. Gibt das Beschriftungs-Shape zurück.Returns the callout shape.

SyntaxSyntax

Ausdruck.expression. DropCallout( _ObjectToDrop_ , _TargetShape_ )

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] Die Legende, die der Seite hinzugefügt werden soll.The callout to add to the page. Kann ein Master-, MasterShortcut-, Shape-oder IDataObject -Objekt sein.Can be a Master, MasterShortcut, Shape, or IDataObject object.
TargetShapeTargetShape ErforderlichRequired ShapeShape Das vorhandene Shape, mit dem die Beschriftung verknüpft werden sollThe existing shape with which to associate the callout.

RückgabewertReturn value

ShapeShape

BemerkungenRemarks

Wenn der ObjectToDrop -Parameter kein Microsoft Visio-Objekt ist, gibt Visio den Fehler "Ungültiger Parameter" zurück.If the ObjectToDrop parameter is not a Microsoft Visio object, Visio returns an Invalid Parameter error. Wenn der übergebene Wert ein Shape ist, das nicht dem Kontext der Methode entspricht, gibt Visio den Fehler "Ungültige Quelle" aus.If the value you pass is a shape that does not match the context of the method, Visio returns an Invalid Source error.

Wenn die TargetShape -Paremeter den Wert NULL aufweist, platziert Visio das Legenden-Shape in der Mitte der Seite und ordnet es keinen Ziel Formen zu.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. Wenn die angegebenen Ziel-Shapes keine Mitglieder der obersten Ebene der Seite sind, gibt Visio den Fehler "Ungültiger Parameter" aus.If the specified target shapes are not top-level members of the page, Visio returns an Invalid Parameter error.

Die DropCallout -Methode entspricht dem Befehl Legende einfügen in der Visio-Benutzeroberfläche.The DropCallout method corresponds to the Insert Callout command in the Visio user interface. (Klicken Sie auf der Registerkarte Einfügen auf Beschriftung.)(On the Insert tab, click Callout.)

BeispielExample

Im folgenden Beispiel für Visual Basic für Applikationen (VBA) wird gezeigt, wie Sie mit der DropCallout -Methode der aktiven Seite eine Legende hinzufügen und diese einer bestimmten Form zuordnen.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

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.