Propriété DataRecordset.LinkReplaceBehavior (Visio)
Récupère ou définit le comportement des liaisons existantes entre les formes et les lignes de données lorsque les méthodes qui lient les formes aux données sont appelées. Lecture-écriture.
Remarque
Cet objet ou ce membre Visio est disponible uniquement pour les titulaires d’une licence d’utilisation de Visio Professionnel 2013.
Syntaxe
expression. LinkReplaceBehavior
Expression Expression qui renvoie un objet DataRecordset .
Valeur renvoyée
VisLinkReplaceBehavior
Remarques
Les constantes suivantes pour les comportements de remplacement de liaison sont déclarées par la bibliothèque de types Visio dans VisLinkReplaceBehavior :
| Constante | Valeur | Description |
|---|---|---|
| visLinkReplaceAlways | 1 | Remplace toujours les liaisons de formes possédant des liaisons existantes |
| visLinkReplaceNever | 0 | Ne remplace jamais les liaisons de formes possédant des liaisons existantes |
| visLinkReplacePrompt | 2 | Invitez l’utilisateur avant de remplacer les liens lorsque l’utilisateur tente de créer des liens dans l’interface utilisateur de Visio. |
Ces options correspondent aux options disponibles dans la boîte de dialogue Propriétés, sous l'onglet correspondant au jeu d'enregistrements de données affiché dans la fenêtre Données externes. (Dans la fenêtre Données externes, sous l'onglet correspondant au jeu d'enregistrements de données, cliquez avec le bouton droit, pointez sur Source de données, puis cliquez sur Propriétés.)
Les méthodes affectées par ce paramètre de propriété incluent Selection.LinkToData, Shape.LinkToData et Selection.AutomaticLink.
Dans l'interface utilisateur, lorsque les utilisateurs tentent d'établir une liaison à des formes de données possédant déjà des liaisons vers des données et si la valeur de la propriété est : visLinkReplacePrompt, Visio répond en ouvrant une boîte de dialogue pour informer les utilisateurs que leurs actions risquent de rompre les liaisons existantes et pour leur demander s'ils souhaitent poursuivre. Étant donné que l'ouverture d'une boîte de dialogue n'est pas une réponse appropriée à un appel de méthode, lorsque vous liez des formes en appelant l'une de ces méthodes, Visio traite la valeur visLinkReplacePrompt comme s'il s'agissait de la valeur visLinkReplaceAlways. Autrement dit, ces deux paramètres diffèrent dans la façon dont ils affectent le comportement dans l’interface utilisateur, mais pas le comportement programmatique. Il convient donc de définir par défaut le comportement qui consiste à toujours remplacer les liaisons existantes lorsque des liaisons sont créées par programme, mais à afficher une invite lorsque des liaisons sont créées dans l'interface utilisateur.
Lorsque LinkReplaceBehavior est défini sur visLinkReplaceNever, les deux méthodes LinkToData sont désactivées et les appels à celles-ci échouent.
Le paramètre LinkReplaceBehavior affecte également le paramètre par défaut de la case à cocher Remplacer les liens existants sur le deuxième écran de l’Assistant Liaison automatique dans l’interface utilisateur de Visio (sous l’onglet Données , cliquez sur Lier automatiquement). Si LinkReplaceBehavior est défini sur visLinkReplaceAlways ou visLinkReplacePrompt, cette zone est sélectionnée par défaut. Si la propriété LinkReplaceBehavior est définie sur visLinkReplaceNever, la case à cocher est désactivée par défaut. Les utilisateurs peuvent modifier le comportement par défaut de l’Assistant en sélectionnant ou en désactivant la case à cocher.
En outre, le paramètre LinkReplaceBehavior détermine le fonctionnement de la méthode Selection.AutomaticLink . Comme c’est le cas pour les méthodes LinkToData , lorsque LinkReplaceBehavior est défini sur visLinkReplaceAlways ou visLinkReplacePrompt, AutomaticLink remplace les liens existants. Et quand LinkReplaceBehavior est défini sur visLinkReplaceNever, AutomaticLink ne remplace pas les liens existants.
Toutefois, la différence entre les méthodes LinkToData et la méthode AutomaticLink est que pour AutomaticLink, vous pouvez remplacer le paramètre LinkReplaceBehavior en transmettant la constante visAutoLinkReplaceExistingLinks ou visAutoLinkDontReplaceExistingLinks de l’énumération VisAutoLinkBehaviors à la méthode en tant que paramètre AutoLinkBehavior.
Par exemple, si LinkReplaceBehavior est défini sur visLinkReplaceNever, vous pouvez spécifier qu’AutomaticLink remplace néanmoins les liens existants en lui transmettant visAutoLinkReplaceExistingLinks.
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.