Méthode Selection.LinkToData (Visio)

Article
04/07/2023

Lie une sélection de formes à une seule ligne de données d'un jeu d'enregistrements de données.

Remarque

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

Syntaxe

expression. LinkToData( _DataRecordsetID_ , _DataRowID_ , _AutoApplyDataGraphics_ )

Expression Expression qui renvoie un objet Selection .

Parameters

Nom	Requis/Facultatif	Type de données	Description
DataRecordsetID	Obligatoire	Long	ID du jeu d’enregistrements de données contenant les données à lier.
DataRowID	Obligatoire	Long	ID de la ligne du jeu d'enregistrements de données qui contient l'enregistrement de données spécifique à lier.
AutoApplyDataGraphics	Facultatif	Boolean	Spécifie si un graphique de données doit être appliqué automatiquement aux formes liées. Voir la section Remarques pour plus d'informations.

Valeur renvoyée

Aucune

Remarques

La méthode Selection.LinkToData fonctionne comme la méthode Shape.LinkToData de l’objet Shape, à la différence qu’elle lie une sélection de formes, au lieu d’une seule forme, à une seule ligne de données.

Si Visio ne parvient pas à établir une liaison entre une forme et la ligne de données, il ignore cette forme et passe à la forme suivante dans la sélection. Après avoir exécuté la méthode, pour déterminer si toutes les formes de la sélection sont réellement liées à la ligne de données, appelez la méthode Shape.GetLinkedDataRow sur chaque forme de la sélection. Si cette méthode échoue pour une forme, cela signifie que cette dernière n’est pas liée à la ligne de données. Visio réussit généralement à lier une ligne à une forme, sauf si la forme est déjà liée à des données et que le paramètre link-replacement-behavior pour le jeu d’enregistrements de données spécifie que le lien ne doit pas être remplacé.

Si vous transmettez la valeur True pour le paramètre AppliquerAutoGraphiquesDonnées, Visio réapplique le graphique de données existant aux formes auxquelles des graphiques de données ont déjà été appliqués avant l'appel de la méthode. Pour les formes auxquelles aucun graphique de données n'a été appliqué, Visio applique le graphique de données dernièrement appliqué aux autres formes du document actif.

Exemple

La macro Microsoft Visual Basic pour Applications (VBA) ci-dessous illustre comment utiliser la méthode LinkToData pour lier les formes d'une sélection à une ligne de données.

Avant d’exécuter cette macro, placez plusieurs formes sur la page et ajoutez au moins un jeu d’enregistrements de données à la collection DataRecordsets du document. La macro utilise l’ID du jeu d’enregistrements de données dernièrement ajouté à la collection. Elle lie les formes sélectionnées aux données de la première ligne du jeu d’enregistrements de données.

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoSelection As Visio.Selection 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    ActiveWindow.DeselectAll 
    ActiveWindow.SelectAll 
     
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.LinkToData vsoDataRecordset.ID, 1, True 
 
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