Application.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 Microsoft Visio Professional 2010 or Visio Premium 2010.

Version Information

Version Added: Visio 2007

Syntax

Private Sub expression _ShapeLinkAdded(ByVal Shape As [IVSHAPE], ByVal DataRecordsetID As Long, ByVal DataRowID As Long)

expression An expression that returns a Application 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 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'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.