Vue d'ensemble du modèle objet Visio
Mise à jour : novembre 2007
Pour développer des solutions Visual Studio Tools pour Office pour Microsoft Office Visio, vous pouvez interagir avec le modèle objet Visio. Ce modèle objet se compose de classes et d'interfaces fournies dans l'assembly PIA (Primary Interop Assembly) pour Visio et définies dans l'espace de noms Microsoft.Office.Interop.Visio.
Cette rubrique propose une vue d'ensemble succincte du modèle objet Visio. Pour plus d'informations sur l'utilisation du modèle objet Visio pour effectuer des tâches dans des projets Visual Studio Tools pour Office, consultez les rubriques suivantes :
Fonctionnement du modèle objet Visio
Visio fournit de nombreux objets avec lesquels vous pouvez interagir. Ces objets sont organisés dans une hiérarchie qui suit de près l'interface utilisateur. En haut de la hiérarchie figure l'objet Microsoft.Office.Interop.Visio.Application, qui représente l'instance actuelle de Visio. L'objet Microsoft.Office.Interop.Visio.Application contient les objets Microsoft.Office.Interop.Visio.Document et Microsoft.Office.Interop.Visio.Page , ainsi que les collections Microsoft.Office.Interop.Visio.Documents et Microsoft.Office.Interop.Visio.Pages. Chacun de ces objets et collections possède de nombreuses méthodes et propriétés auxquelles vous pouvez accéder en vue de le manipuler et d'interagir avec.
Pour plus d'informations, consultez la documentation de référence sur VBA pour les objets Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Document et Microsoft.Office.Interop.Visio.Page, ainsi que pour les collections Microsoft.Office.Interop.Visio.Documents et Microsoft.Office.Interop.Visio.Pages.
Les rubriques suivantes décrivent brièvement les objets de premier niveau et la façon dont ils interagissent les uns avec les autres. Ces objets incluent les objets suivants :
Objet application
Objet Document
Objet page
Objet Application
L'objet Microsoft.Office.Interop.Visio.Application représente l'application Visio et est le parent de l'ensemble des autres objets. Ses membres s'appliquent généralement en bloc à Visio. Vous pouvez utiliser les propriétés et méthodes des objets Microsoft.Office.Interop.Visio.Application et Microsoft.Office.Interop.Visio.ApplicationSettings pour contrôler l'environnement Visio.
Dans les projets de complément au niveau de l'application, vous pouvez accéder à l'objet Microsoft.Office.Interop.Visio.Application à l'aide du champ Application de la classe ThisAddIn. Pour plus d'informations, consultez Programmation de compléments d'application.
Objet Document
L'objet Microsoft.Office.Interop.Visio.Document est essentiel à la programmation de Visio. Il représente un dessin, un stencil ou un fichier modèle. Lorsque vous ouvrez ou créez un document Visio, vous créez un objet Microsoft.Office.Interop.Visio.Document, qui est ajouté à la collection Microsoft.Office.Interop.Visio.Documents de l'objet Microsoft.Office.Interop.Visio.Application.
Le document qui a le focus et le document actif. Il est représenté par la propriété Microsoft.Office.Interop.Visio.Application.ActiveDocument de l'objet Microsoft.Office.Interop.Visio.Application.
Objet page
L'objet Microsoft.Office.Interop.Visio.Page représente la zone de dessin d'une page de premier plan ou d'arrière-plan. Vous pouvez utiliser la propriété Microsoft.Office.Interop.Visio.Page.Background pour déterminer si une page est une page de premier plan ou d'arrière-plan.
Pour créer des formes, vous pouvez utiliser des méthodes, dont Microsoft.Office.Interop.Visio.Page.DrawSpline et Microsoft.Office.Interop.Visio.Page.DrawOval. En outre, vous pouvez extraire des formes de base à partir de stencils et placer ces formes sur une page à l'aide de la méthode Microsoft.Office.Interop.Visio.Page.Drop ou Microsoft.Office.Interop.Visio.Page.DropMany.
Utilisation de la documentation relative au modèle objet Visio
Pour plus d'informations sur les classes que vous pouvez utiliser dans le modèle objet Visio, consultez les documents suivants. La documentation MSDN Library en ligne fournit des informations sur le modèle objet Visio et des exemples de code dans VBA. Le Kit de développement logiciel Visio 2007 (SDK) propose des exemples de code en Visual Basic et C#. Le Kit de développement logiciel (SDK) Visio 2007 fournit également des outils de publication et des modèles Visual Studio.
Microsoft Office Visio 2007
Bienvenue dans le Kit de développement logiciel (SDK) Microsoft Office Visio 2007
Bienvenue dans la référence de schéma XML de Microsoft Office Visio 2007
Bienvenue dans la référence ShapeSheet de Microsoft Office Visio 2007
Microsoft Office Visio 2003
Types supplémentaires dans les assemblys PIA
Vous pouvez retrouver des types dans les assemblys PIA (Primary Interop Assembly) qui ne sont pas visibles par VBA en raison de différences d'implémentation. VBA fournit une vue du modèle objet Visio qui inclut uniquement les objets et membres que vous pouvez utiliser directement. Les assemblys PIA (Primary Interop Assembly) exposent le même modèle objet, mais incluent également d'autres interfaces, classes et membres qui convertissent les objets du modèle objet COM en code managé. Ces éléments supplémentaires ne sont pas conçus pour être utilisés directement dans votre code.
Pour plus d'informations, consultez Overview of Classes and Interfaces in the Office Primary Interop Assemblies et Assemblys PIA (Primary Interop Assembly) Office.
.gif "Remarque") Remarque : |
|---|
À l'heure actuelle, il n'existe aucune documentation de référence relative aux assemblys PIA (Primary Interop Assembly) Visio. |
Référence VBA
Tous les objets et membres de la référence VBA correspondent à des classes et des membres de l'assembly PIA que vous utilisez dans des projets Visual Studio Tools pour Office. Par exemple, l'objet Visio.Application de la documentation relative à VBA de Visio correspond à la classe Microsoft.Office.Interop.Visio.Application de l'assembly PIA (Primary Interop Assembly).
La référence VBA présente les avantages suivants :
Elle documente les modèles objet de Visio 2007 et 2003.
Elle propose des exemples de code pour la plupart des membres.
La référence VBA présente les inconvénients suivants :
- Elle fournit uniquement la syntaxe et des exemples de code pour VBA. Pour utiliser les exemples de code dans un projet Visual Studio Tools pour Office, vous devez traduire le code VBA dans Visual Basic ou Visual C#.