Programmieren von Add-Ins auf Anwendungsebene

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Anwendungsebene Microsoft Office-Version 2007 Microsoft Office System Microsoft Office 2003 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

Projekte auf Anwendungsebene

Microsoft Office-Version

2007 Microsoft Office System
Microsoft Office 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Wenn Sie eine Microsoft Office-Anwendung erweitern, indem Sie ein Visual Studio Tools for Office-Add-In erstellen, schreiben Sie Code direkt für die ThisAddIn-Klasse im Projekt. Sie können diese Klasse verwenden, um Aufgaben auszuführen, beispielsweise das Zugreifen auf das Objektmodell der Microsoft Office-Hostanwendung, das Anpassen der Benutzeroberfläche der Anwendung und das Verfügbarmachen von Objekten im Add-In für andere Office-Projektmappen.

Allgemeine Informationen zu Add-Ins auf Anwendungsebene und andere Typen von Projektmappen, die Sie mit Visual Studio Tools for Office erstellen können, finden Sie unter Übersicht über die Entwicklung von Office-Projektmappen.

Schreiben von Code im Add-In-Projekt

Sie können den Add-In-Code zunächst in der ThisAddIn-Klasse schreiben. Visual Studio Tools for Office generiert diese Klasse automatisch in der Codedatei ThisAddIn.vb (in Visual Basic) oder ThisAddIn.cs (in C#) im Add-In-Projekt.

Es gibt zwei Standardereignishandler in der ThisAddIn-Klasse. Wenn Code beim Laden des Add-Ins ausgeführt werden soll, fügen Sie dem ThisAddIn_Startup-Ereignishandler Code hinzu. Wenn Code direkt vor dem Entladen des Add-Ins ausgeführt werden soll, fügen Sie dem ThisAddIn_Shutdown-Ereignishandler Code hinzu. Weitere Informationen hierzu finden Sie unter Visual Studio Tools for Office-Projektereignisse.

Die ThisAddIn-Klasse leitet die meisten ihrer Features von der AddIn-Klasse ab. AddIn bietet die Basisfunktionalität, die von allen Visual Studio Tools for Office-Add-Ins gemeinsam genutzt wird. Weitere Informationen über die AddIn-Klasse finden Sie unter AddIn-Hostelement.

Zugreifen auf das Objektmodell der Hostanwendung

Auf das Objektmodell der Hostanwendung können Sie über das Feld Application der ThisAddIn-Klasse zugreifen. Dieses Feld gibt ein Objekt zurück, das die aktuelle Instanz der Hostanwendung darstellt.

Im folgenden Codebeispiel wird gezeigt, wie Sie das Application-Feld verwenden, um eine neue Arbeitsmappe in einem Add-In für Microsoft Office Excel zu erstellen. Dieses Beispiel soll in der ThisAddIn-Klasse ausgeführt werden.

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()

Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

Sie können dieselbe Aufgabe auch außerhalb der ThisAddIn-Klasse ausführen, indem Sie mithilfe des Globals-Objekts auf die ThisAddIn-Klasse zugreifen. Weitere Informationen über das Globals-Objekt finden Sie unter Globaler Zugriff auf eigene Objekte in Visual Studio Tools for Office-Projekte.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

In der folgenden Tabelle wird der Typ des Rückgabewerts für das Application-Feld in jedem Add-In-Projekt aufgeführt.

Hostanwendung	Typ des Rückgabewerts
Microsoft Office Excel	Microsoft.Office.Interop.Excel.Application
Microsoft Office InfoPath	Microsoft.Office.Interop.InfoPath.Application
Microsoft Office Outlook	Microsoft.Office.Interop.Outlook.Application
Microsoft Office PowerPoint	Microsoft.Office.Interop.PowerPoint.Application
Microsoft Office Project	Microsoft.Office.Interop.MSProject.Application
Microsoft Office Visio	Microsoft.Office.Interop.Visio.Application
Microsoft Office Word	Microsoft.Office.Interop.Word.Application

Anpassen der Benutzeroberfläche von Microsoft Office-Anwendungen

Mithilfe eines Add-Ins auf Anwendungsebene können Sie die Benutzeroberfläche von Microsoft Office-Anwendungen programmgesteuert anpassen. Für Microsoft Office 2003-Anwendungen zählen Menüs und Symbolleisten zu den Benutzeroberflächenfeatures, die Sie anpassen können. Anwendungen in 2007 Microsoft Office System verfügen über einige andere Benutzeroberflächenfeatures, die angepasst werden können. Zu diesen Features gehören die Multifunktionsleiste, benutzerdefinierte Aufgabenbereiche und Outlook-Formularbereiche. Weitere Informationen finden Sie unter Anpassung der Office-Benutzeroberfläche.

Visual Studio Tools for Office stellt Designer und Klassen bereit, die Sie verwenden können, um benutzerdefinierte Aufgabenbereiche, angepasste Multifunktionsleisten und Outlook-Formularbereiche zu erstellen. Mit diesen Designern und Klassen wird der Anpassungsprozess für diese Features vereinfacht. Weitere Informationen finden Sie unter Übersicht über benutzerdefinierte Aufgabenbereiche, Multifunktionsleisten-Designer und unter Erstellen von Outlook-Formularbereichen.

Wenn Sie eines dieser Features auf eine Weise anpassen möchten, die nicht von Klassen und Designern in Visual Studio Tools for Office unterstützt wird, können Sie die Features anpassen, indem Sie eine Erweiterbarkeitsschnittstelle im Add-In implementieren. Weitere Informationen hierzu finden Sie unter Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen.

Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie auch die Benutzeroberfläche von Word-Dokumenten und Excel-Arbeitsmappen ändern, indem Sie Hostelemente generieren, die das Verhalten von Dokumenten und Arbeitsmappen erweitern. Dies ermöglicht Ihnen, Dokumenten und Arbeitsblättern verwaltete Steuerelemente und Visual Studio Tools for Office-Smarttags hinzuzufügen. Weitere Informationen hierzu finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Aufrufen von Code in Add-Ins auf Anwendungsebene von anderen Office-Projektmappen

Sie können Objekte im Add-In für andere Office-Projektmappen verfügbar machen. Dies ist nützlich, wenn das Add-In einen Dienst bietet, den auch andere Office-Projektmappen nutzen sollen. Wenn Sie beispielsweise ein Add-In für Microsoft Office Excel haben, das Berechnungen für Finanzdaten von einem Webdienst durchführt, können andere Office-Projektmappen diese Berechnungen durchführen, indem sie das Excel-Add-In zur Laufzeit aufrufen.

Weitere Informationen hierzu finden Sie unter Aufrufen von Code in Add-Ins auf Anwendungsebene von anderen Office-Projektmappen.