Vue d'ensemble du modèle objet Visio

Article
08/10/2011

Pour développer des solutions 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 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 obtenir des informations complètes sur le modèle objet Visio, vous pouvez vous reporter à la documentation de référence du modèle objet VBA Visio. La documentation de référence du modèle objet VBA contient des informations sur le modèle objet Visio, tel qu'exposé au code VBA. La documentation de référence du modèle objet VBA pour Visio peut être consultée aux emplacements suivants :

Tous les objets et membres abordés dans la documentation de référence du modèle objet VBA correspondent aux types et aux membres de l'assembly PIA Visio. Par exemple, l'objet Document dans la documentation de référence du modèle objet VBA correspond au type Microsoft.Office.Interop.Visio.Document dans l'assembly PIA Visio. Même si la documentation de référence du modèle objet VBA fournit des exemples de code pour la plupart des propriétés, méthodes et événements, vous devrez traduire le code VBA en Visual Basic ou Visual C#, si vous souhaitez les utiliser dans un projet de complément Visio créé à l'aide de Visual Studio.

Notes

À l'heure actuelle, il n'existe aucune documentation de référence relative à l'assembly PIA (Primary Interop Assembly) Visio.

Pour obtenir des exemples de code connexes et des outils supplémentaires pour la création de solutions Visio, consultez les téléchargements suivants :

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 Vue d'ensemble des classes et interfaces des assemblys PIA (Primary Interop Assembly) Office (page éventuellement en anglais) et Assemblys PIA (Primary Interop Assembly) Office.