Übersicht über das Visio-Objektmodell
Zur Entwicklung von Office-Projektmappen für Microsoft Office Visio 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 zur Verwendung des Visio-Objektmodells für bestimmte Aufgaben in Office-Projekten finden Sie unter den folgenden Themen:
Grundlegendes zum Visio-Objektmodell
Visio stellt zahlreiche Objekte bereit, mit denen Sie interagieren können. Diese Objekte werden in einer Hierarchie angeordnet, die eng an die Benutzeroberfläche angelehnt ist. Oben in der Hierarchie befindet sich 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 die und Microsoft.Office.Interop.Visio.Page die Microsoft.Office.Interop.Visio.Document Objekte sowie die und Microsoft.Office.Interop.Visio.Pages Die Microsoft.Office.Interop.Visio.Documents Auflistungen. Jedes dieser Objekte bzw. jede dieser Auflistungen verfügt über zahlreiche Methoden und Eigenschaften, auf die Sie zwecks Bearbeitung und Interaktion zugreifen können.
Weitere Informationen finden Sie in der VBA-Referenzdokumentation für die Objekte Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Documentund Microsoft.Office.Interop.Visio.Page sowie für die Auflistungen Microsoft.Office.Interop.Visio.Documents und Microsoft.Office.Interop.Visio.Pages .
In den folgenden Abschnitten werden die Objekte der obersten Ebene und ihre Interaktion miteinander kurz beschrieben. Dazu gehören die folgenden Objekte:
Anwendungsobjekt
Document-Objekt
Page-Objekt
Anwendungsobjekt
Das Microsoft.Office.Interop.Visio.Application -Objekt stellt die Visio-Anwendung dar und ist das übergeordnete Element aller anderen Objekte. Seine Elemente gelten normalerweise für Visio als Ganzes. Sie können die Eigenschaften und Methoden der Microsoft.Office.Interop.Visio.Application und der Microsoft.Office.Interop.Visio.ApplicationSettings Objekte verwenden, um die Visio-Umgebung zu steuern.
In VSTO-Add-In-Projekten können Sie mithilfe Application des Felds der ThisAddIn Klasse auf das Objekt "Microsoft.Office.Interop.Visio.Application" zugreifen. Weitere Informationen finden Sie unter Programming VSTO Add-Ins.
Document-Objekt
Das Microsoft.Office.Interop.Visio.Document-Objekt ist für die Programmierung von Visio zentral. Es stellt eine Zeichnungs-, Schablonen- oder Vorlagendatei dar. Wenn Sie ein Visio-Dokument öffnen oder ein neues Dokument erstellen, erstellen Sie ein neues Microsoft.Office.Interop.Visio.Document-Objekt, das der Microsoft.Office.Interop.Visio.Documents-Auflistung des Objekts "Microsoft.Office.Interop.Visio.Application" hinzugefügt wird.
Das Dokument, das den Fokus besitzt, wird als das aktive Dokument bezeichnet. Sie 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 eines Vordergrundblatts oder eines Hintergrundblatts dar. Mithilfe der Microsoft.Office.Interop.Visio.Page.Background-Eigenschaft können Sie feststellen, ob es sich bei der Seite um eine Vorder- oder Hintergrundseite handelt.
Zum Erstellen von Shapes können Sie Methoden wie die Microsoft.Office.Interop.Visio.Page.DrawSpline-Methode und die Microsoft.Office.Interop.Visio.Page.DrawOval-Methode verwenden. Darüber hinaus können Sie Masters aus Schablonen abrufen und die Shapes mithilfe der Microsoft.Office.Interop.Visio.Page.Drop-Methode oder Microsoft.Office.Interop.Visio.Page.DropMany-Methode auf einer Seite platzieren.
Verwenden der Visio-Objektmodelldokumentation
Ausführliche Informationen zum Visio-Objektmodell finden Sie in der VBA-Objektmodellreferenz für Visio. Die VBA-Objektmodellreferenz dokumentiert das Visio-Objektmodell, das für VBA (Visual Basic for Applications) verfügbar gemacht wird. Weitere Informationen finden Sie unter Visio-Objektmodellreferenz.
Alle Objekte und Member in der VBA-Objektmodellreferenz entsprechen Typen und Membern in der primären Interopassembly (PIA) für Visio. Beispielsweise entspricht das Document Objekt in der VBA-Objektmodellreferenz dem Microsoft.Office.Interop.Visio.Document-Typ in der Visio-PIA. Obwohl die VBA-Objektmodellreferenz Codebeispiele für die meisten Eigenschaften, Methoden und Ereignisse enthält, müssen Sie den VBA-Code in dieser Referenz in Visual Basic oder Visual C# übersetzen, wenn Sie ihn in einem mit Visual Studio erstellten Visio VSTO-Add-In-Projekt verwenden möchten.
Hinweis
Derzeit ist keine Referenzdokumentation für die primäre Interopassembly für Visio verfügbar.
Verwandte Codebeispiele und zusätzliche Tools zum Erstellen von Visio-Lösungen finden Sie im Visio 2010 Software Development Kit.
Weitere Typen in primären Interopassemblys
Primäre Interopassemblys können Typen enthalten, die aufgrund von Unterschieden bei der Implementierung nicht für VBA 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 zusätzlich aber weitere Schnittstellen, Klassen und Member, die Objekte im COM-Objektmodell in verwalteten Code übersetzen. Diese zusätzlichen Elemente sollten nicht direkt im Code verwendet werden.
Weitere Informationen finden Sie unter Übersicht über Klassen und Schnittstellen in den primären Interopassemblys von Office und primären Interopassemblys von Office.