Shape.ShapeLinkAdded event (Visio)
Occurs after a shape is linked to a data row.
Note
This Visio object or member is available only to licensed users of Visio Professional 2013.
Syntax
expression.ShapeLinkAdded (Shape, DataRecordsetID, DataRowID)
expression An expression that returns a Shape object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Shape | Required | [IVSHAPE] | The shape that is linked to data. |
| DataRecordsetID | Required | Long | The ID of the data recordset containing the data row linked to the shape. |
| DataRowID | Required | Long | The ID of the data row linked to the shape. |
Remarks
The ShapeLinkAdded event of the Shape object does not occur when a link is created between the source shape itself and a data row. It occurs only when a link is added between one or more sub-shapes of the source shape and a data row or rows.
The ShapeLinkAdded event is one of a group of events for which the EventInfo property of the Application object contains extra information.
When the ShapeLinkAdded event is fired, the EventInfo property returns the following string:
/DataRecordsetID = n /DataRowID = m
where n and m represent the IDs of the data recordset and data row, respectively, associated with the event.
If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.
If you want to create your own Event objects, use the Add or AddAdvise method.
To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.
To create an Event object that receives notification, use the AddAdvise method.
To find an event code for the event that you want to create, see Event codes.
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.