Partager via


À propos de la bibliothèque de types Visio

Les produits Visio incluent une bibliothèque de types qui définit les objets, les propriétés, les méthodes, les événements et les constantes que Visio expose aux clients Automation. Pour utiliser la bibliothèque de types de Visio, un environnement de développement doit la référencer. Le projet Visual Basic pour Applications (VBA) d’un document Visio fait automatiquement référence à la bibliothèque de types Visio. Dans d'autres environnements de développement, vous devez définir vous-même la référence à la bibliothèque.

Les noms des bibliothèques référencées par votre projet VBA sont affichés dans la liste Projet/bibliothèque de l'Explorateur d'objets de l'Éditeur Microsoft Visual Basic.

Avantages liés à l'utilisation d'une bibliothèque de types

Une bibliothèque de types s'avère particulièrement utile pour les raisons suivantes :

  • Les informations d'une bibliothèque de types servent d'entrées pour les explorateurs d'objets fournis par VBA et d'autres environnements de développement. Utilisez les navigateurs d’objets pour afficher les descriptions des objets fournis par les serveurs Automation (tels que l’application Visio) installés sur votre système. Par exemple, vous pouvez consulter la syntaxe d'une propriété, d'une méthode ou d'un événement Visio et coller le code affiché par l'explorateur dans votre programme.

  • Une bibliothèque de types permet aux environnements de développement de lier le code de votre programme au code de serveur Automation au moment de la compilation (création) plutôt que de manière dynamique au moment de l'exécution. De ce fait, votre programme s'exécute souvent plus rapidement. Vous pouvez par exemple utiliser Visio.Page, Visio.Shape, Visio.Document, etc., au lieu de Object.

Résolution d'ambiguïtés relatives aux noms d'objet

Votre projet VBA ou programme Visual Basic peut référencer de nombreuses bibliothèques de types. Les bibliothèques déclarent parfois des éléments avec un nom identique. Par exemple, Visio et Excel exposent un objet appelé Application. Si plusieurs bibliothèques déclarent un élément sous le même nom, VBA et Microsoft Visual Basic relient le nom à la bibliothèque dotée de la priorité la plus haute.

Un moyen de lever les ambiguïtés de nom d’objet est d’attribuer aux types d’objet un préfixe constitué du nom de la bibliothèque correspondante. Par exemple :

Dim vsoApplication As Visio.Application 
Dim xlApplication As Excel.Application

Si votre code s’exécute exclusivement dans le contexte d’un projet VBA d’un document Visio, vous n’avez pas besoin de préfixer les noms des types d’objets Visio avec Visio, bien que ce soit une bonne idée. Dans ce cas, la bibliothèque de types Visio a une priorité plus élevée que les autres bibliothèques qui peuvent déclarer des noms en conflit. VBA ne vous permet pas de modifier la priorité de la bibliothèque de types Visio lorsque vous utilisez VBA dans Visio, mais dans d’autres environnements de développement, vous pouvez modifier la priorité de la bibliothèque de types Visio.

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.