Übersicht über das Visio-Objektmodell
Bei der Entwicklung von Office-Projektmappen für Microsoft Office Visio können Sie mit dem Visio-Objektmodell kommunizieren.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 Aufgaben in Office-Projekten finden Sie in 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
.gif "Cc160740.collapse_all(de-de,VS.110).gif")
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
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 2010 Object Model Referenceunter.
Alle Objekte und Member in der VBA-Objektmodellreferenz entsprechen Typen und Membern in der primären Interopassembly (PIA) für Visio.Das Document-Objekt in der VBA-Objektmodellreferenz entspricht z. B. 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-Add-In-Projekt verwenden möchten.
.gif "Hinweis") Hinweis |
|---|
Zurzeit ist keine Referenzdokumentation für die primäre Interopassembly für Visio verfügbar. |
Eine verwandte Codebeispiele sowie weitere Tools zum Erstellen von Visio-Projektmappen, finden Sie unter Visio 2010 Software Development Kitweitere Informationen.
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 in der Übersicht über Klassen und Schnittstellen in den primären Interopassemblys für Office (möglicherweise in englischer Sprache) und unter Primäre Interopassemblys in Office.