Méthode Page.GetShapesLinkedToDataRow (Visio)

Article
04/07/2023

Renvoie un tableau qui contient toutes les formes sur la page active qui sont liées aux données de la ligne de données spécifiée du jeu d'enregistrements de données défini.

Remarque

Cet objet ou ce membre Visio est disponible uniquement pour les titulaires d’une licence d’utilisation de Visio Professionnel 2013.

Syntaxe

expression. GetShapesLinkedToDataRow( _DataRecordsetID_ , _DataRowID_ , _ShapeIDs()_ )

Expression Expression qui renvoie un objet Page .

Parameters

Nom	Requis/Facultatif	Type de données	Description
DataRecordsetID	Obligatoire	Long	ID d'un jeu d'enregistrements de données contenu dans le document actif.
DataRowID	Obligatoire	Long	ID d'une ligne de données du jeu d'enregistrements spécifié dans IDJeuEnregistrementsDonnées.
ShapeIDs()	Obligatoire	Long	Paramètre sortant. Tableau de type Long que la méthode renvoie rempli avec les ID de forme des formes de la page liée à la ligne de données spécifiée dans DataRowID dans le jeu d’enregistrements de données spécifié dans DataRecordsetID.

Valeur renvoyée

Aucune

Remarques

Pour le paramètre IDForme(), transmettez un tableau vide et sans dimension de type Long. S’il n’existe aucune forme sur la page liée à la ligne de données spécifiée par DataRowID dans le jeu d’enregistrements de données spécifié par DataRecordsetID, GetShapesLinkedToDataRow renvoie un tableau vide.

Pour déterminer les ID de toutes les lignes de données dans un jeu d’enregistrements de données, utilisez la méthode DataRecordset.GetDataRowIDs . Notez que les ID de ligne de données ne correspondent pas nécessairement toujours à la position logique des lignes de données dans le jeu d’enregistrements de données.

Exemple

La macro Microsoft Visual Basic pour Applications (VBA) ci-dessous illustre comment utiliser la méthode GetShapesLinkedToDataRow pour déterminer les ID de forme des formes sur la page qui sont liées aux données de la ligne avec l'ID numéro 1 dans le jeu d'enregistrements dernièrement ajouté à la collection DataRecordsets du document actif. Elle affiche les ID de forme dans la fenêtre Exécution.

Avant d’exécuter cette macro, utilisez la méthode DataRecordsets.Add ou un autre moyen pour ajouter au moins un jeu d’enregistrements de données à la collection DataRecordsets et assurez-vous qu’il existe au moins une forme sur la page active liée aux données de la ligne de données avec l’ID numéro 1 dans le jeu d’enregistrements de données.

Public Sub GetShapesLinkedToDataRow_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intRecordsetCount As Integer 
    Dim alngShapeIDs() As Long 
    Dim lngDataRowID As Long 
    Dim intArrayCounter As Integer 
     
    intRecordsetCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intRecordsetCount) 
     
    lngDataRowID = 1 
     
    ActivePage.GetShapesLinkedToDataRow vsoDataRecordset.ID, lngDataRowID, alngShapeIDs 
     
    For intArrayCounter = LBound(alngShapeIDs) To UBound(alngShapeIDs) 
        Debug.Print alngShapeIDs(intArrayCounter) 
    Next 
     
End Sub

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via