Page.GetShapesLinkedToData Method

Returns an array of all shapes on the active page linked to data in the specified data recordset.

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

expression.GetShapesLinkedToData(DataRecordsetID, ShapeIDs())

expression   An expression that returns a Page object.

Parameters

Return Value
Nothing

Remarks

For the ShapeIDs() parameter, pass an empty, dimensionless array of type Long. If there are no linked shapes on the page, GetShapesLinkedToData will return an empty array.

To determine the specific data row in the data recordset shapes are linked to, use the **Page.GetShapesLinkedToDataRow**method.

Example

The following Microsoft Visual Basic for Applications (VBA) macro shows how to use the GetShapesLinkedToData method to determine the shape IDs of the shapes on the page linked to data in the data recordset most recently added to the DataRecordsets collection of the current document. It prints the shape IDs in the Immediate window.

Before running this macro, use the DataRecordsets.Add method or another means to add at least one data recordset to the DataRecordsets collection, and make sure there is at least one shape on the active page linked to data in the data recordset.

  Public Sub GetShapesLinkedToData_Example()
Dim vsoDataRecordset As Visio.DataRecordset
Dim intRecordsetCount As Integer
Dim alngShapeIDs() As Long
Dim intArrayCounter As Integer

intRecordsetCount = Visio.ActiveDocument.DataRecordsets.Count
Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intRecordsetCount)

ActivePage.GetShapesLinkedToData vsoDataRecordset.ID, alngShapeIDs

For intArrayCounter = LBound(alngShapeIDs) To UBound(alngShapeIDs)
    Debug.Print alngShapeIDs(intArrayCounter)
Next

End Sub

See Also

• Page Object
• Page Object Members