Übersicht über das Visio-Objektmodell
Aktualisiert: November 2007
Um Visual Studio Tools for Office-Projektmappen für Microsoft Office Visio zu entwickeln, können Sie mit dem Visio-Objektmodell interagieren. Dieses Objektmodell besteht aus Klassen und Schnittstellen, die in der primären Interopassembly für Visio bereitgestellt und im Microsoft.Office.Interop.Visio-Namespace definiert werden.
Dieses Thema enthält eine kurze Übersicht über das Visio-Objektmodell. Informationen über die Verwendung des Visio-Objektmodells für Aufgaben in Visual Studio Tools for Office-Projekten finden Sie unter den folgenden Themen:
Das Visio-Objektmodell
Visio stellt viele Objekte bereit, mit denen Sie interagieren können. Diese Objekte werden in einer Hierarchie organisiert, die der Benutzeroberfläche eng folgt. Oben in der Hierarchie ist das Microsoft.Office.Interop.Visio.Application-Objekt. Dieses Objekt stellt die aktuelle Instanz von Visio dar. Das Microsoft.Office.Interop.Visio.Application-Objekt enthält das Microsoft.Office.Interop.Visio.Document-Objekt und das Microsoft.Office.Interop.Visio.Page -Objekt sowie die Microsoft.Office.Interop.Visio.Documents-Auflistung und die Microsoft.Office.Interop.Visio.Pages-Auflistung. Jedes dieser Objekte und jede dieser Auflistungen enthält zahlreiche Methoden und Eigenschaften, auf die Sie zugreifen können, um es zu bearbeiten und mit ihm zu interagieren.
Weitere Informationen finden Sie in der VBA-Referenzdokumentation für die Objekte Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Document und Microsoft.Office.Interop.Visio.Page sowie für die Microsoft.Office.Interop.Visio.Documents-Auflistung und die Microsoft.Office.Interop.Visio.Pages-Auflistung.
In den folgenden Abschnitten werden die Objekte der obersten Ebene und ihr Zusammenwirken kurz beschrieben. Dazu gehören die folgenden Objekte:
Application-Objekt
Document-Objekt
Page-Objekt
Application-Objekt
Das Microsoft.Office.Interop.Visio.Application-Objekt stellt die Visio-Anwendung dar und ist das übergeordnete Element aller anderen Objekte. Seine Member gelten i. d. R. für Visio als Ganzes. Sie können die Eigenschaften und Methoden des Microsoft.Office.Interop.Visio.Application-Objekts und des Microsoft.Office.Interop.Visio.ApplicationSettings-Objekts verwenden, um die Visio-Umgebung zu steuern.
In Add-In-Projekten auf Anwendungsebene können Sie auf das Microsoft.Office.Interop.Visio.Application-Objekt zugreifen, indem Sie das Application-Feld der ThisAddIn-Klasse verwenden. Weitere Informationen hierzu finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.
Document-Objekt
Das Microsoft.Office.Interop.Visio.Document-Objekt ist beim Programmieren von Visio von zentraler Bedeutung. Es stellt eine Zeichnungs-, Schablonen- oder Vorlagendatei dar. Wenn Sie ein Visio-Dokument öffnen oder ein neues Dokument erstellen, dann erstellen Sie ein neues Microsoft.Office.Interop.Visio.Document-Objekt, das der Microsoft.Office.Interop.Visio.Documents-Auflistung des Microsoft.Office.Interop.Visio.Application-Objekts hinzugefügt wird.
Das Dokument, das den Fokus besitzt, wird als aktives Dokument bezeichnet. Es wird durch die Microsoft.Office.Interop.Visio.Application.ActiveDocument-Eigenschaft des Microsoft.Office.Interop.Visio.Application-Objekts dargestellt.
Page-Objekt
Das Microsoft.Office.Interop.Visio.Page-Objekt stellt den Zeichnungsbereich einer Vordergrundseite oder einer Hintergrundseite dar. Sie können die Microsoft.Office.Interop.Visio.Page.Background-Eigenschaft verwenden, um festzulegen, ob eine Seite eine Vordergrund- oder eine Hintergrundseite ist.
Zum Erstellen von Shapes können Sie Methoden verwenden, die die Microsoft.Office.Interop.Visio.Page.DrawSpline-Methode und die Microsoft.Office.Interop.Visio.Page.DrawOval-Methode einschließen. Zusätzlich können Sie Masters aus Schablonen abrufen und die Shapes mit der Microsoft.Office.Interop.Visio.Page.Drop-Methode oder der Microsoft.Office.Interop.Visio.Page.DropMany-Methode auf einer Seite platzieren.
Verwenden der Dokumentation für das Visio-Objektmodell
Weitere Informationen über die Klassen, die Sie im Visio-Objektmodell verwenden können, finden Sie in der folgenden Dokumentation. In der MSDN Library-Onlinedokumentation sind Informationen über das Visio-Objektmodell und die Codebeispiele in VBA enthalten. Das Visio 2007 Software Development Kit (SDK) stellt Codebeispiele in Visual Basic und C# bereit. Das Visio 2007 SDK stellt auch Veröffentlichungstools und Visual Studio-Vorlagen bereit.
Microsoft Office Visio 2007
Willkommen bei der Microsoft Visio 2007-Entwicklerreferenz "Als Webseite speichern"
Willkommen bei der Microsoft Office Visio 2007 XML-Schemareferenz
Willkommen bei der Microsoft Office Visio 2007 ShapeSheet-Referenz
Microsoft Office Visio 2003
Informationen über die Microsoft Office Visio ShapeSheet-Referenz [Visio 2003 SDK-Dokumentation]
Willkommen bei der Microsoft Office Visio 2003 XML-Schemareferenz [Visio 2003 SDK-Dokumentation]
Zusätzliche Typen in primären Interopassemblys
Primäre Interopassemblys können Typen enthalten, die für VBA aufgrund von Unterschieden bei der Implementierung nicht sichtbar sind. VBA bietet eine Ansicht des Visio-Objektmodells, das nur die Objekte und Member enthält, die Sie direkt verwenden können. Die primären Interopassemblys machen das gleiche Objektmodell verfügbar, enthalten jedoch andere Schnittstellen, Klassen und Member, die Objekte im COM-Objektmodell in verwalteten Code übersetzen. Diese zusätzlichen Elemente sind nicht für die direkte Verwendung im Code vorgesehen.
Weitere Informationen finden Sie unter Overview of Classes and Interfaces in the Office Primary Interop Assemblies und unter Primäre Interopassemblys in Office.
.gif "Hinweis") Hinweis: |
|---|
Derzeit gibt es keine Referenzdokumentation für die primären Interopassemblys für Visio. |
VBA-Referenz
Alle Objekte und Member in der VBA-Referenz entsprechen Klassen und Membern in der primären Interopassembly, die Sie in Visual Studio Tools for Office-Projekten verwenden. Beispielsweise entspricht das Visio.Application-Objekt in der Visio VBA-Dokumentation der Microsoft.Office.Interop.Visio.Application-Klasse in der primären Interopassembly.
Die VBA-Referenz hat die folgenden Vorteile:
Sie dokumentiert die Objektmodelle sowohl von Visio 2007 als auch von Visio 2003.
Sie stellt Codebeispiele für die meisten Member bereit.
Die VBA-Referenz hat die folgenden Nachteile:
- Sie stellt nur Syntax und Codebeispiele für VBA bereit. Um die Codebeispiele in einem Visual Studio Tools for Office-Projekt zu verwenden, müssen Sie den VBA-Code in Visual Basic oder Visual C# übersetzen.