Page.ShapeLinkAdded Event

Visio Automation Reference

Occurs after a shape is linked to a data row.

ms367259.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_ShapeLinkAdded(ByVal Shape As [IVSHAPE], ByVal DataRecordsetID As Long, ByVal DataRowID As Long)

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

See Also