Shape.ShapeLinkDeleted Event
| Visio Automation Reference |
Occurs after the link between a shape and a data row is deleted.
.gif "ms367283.vs_note(en-us,office.12).gif") Note |
|---|
| This Visio object or member is available only to licensed users of Microsoft Office Visio Professional 2007. |
Version Information
Version Added: Visio 2007
Syntax
Private Sub expression_ShapeLinkDeleted(ByVal Shape As [IVSHAPE], ByVal DataRecordsetID As Long, ByVal DataRowID As Long )
expression An expression that returns a Shape object.
Parameters
| Name | Required/Optional | Data Type | Description |
|---|---|---|---|
| Shape | Required | [IVSHAPE] | The shape whose link to a data row was broken. |
| DataRecordsetID | Required | Long | The ID of the data recordset containing the data row that was linked to the shape. |
| DataRowID | Required | Long | The ID of the data row that was linked to the shape. |
Remarks
The ShapeLinkDeleted event of the Shape object does not occur when the link is broken between the source shape itself and a data row. It occurs only when the link is broken between one or more sub-shapes of the source shape and a data row or rows.
The ShapeLinkDeleted event is one of a group of events for which the EventInfo property of the Application object contains extra information.
When the ShapeLinkDeleted 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're 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 you want to create, see Event codes.
See Also