Freigeben über


AddIn-Hostelement

Aktualisiert: Juli 2008

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 Microsoft.Office.Tools.AddIn-Klasse ist das Hostelement für Add-Ins auf Anwendungsebene, die Sie mithilfe von Visual Studio Tools for Office erstellen. Ein Hostelement ist eine Klasse in einer Visual Studio Tools for Office-Projektmappe, die den Einstiegspunkt für den Code bereitstellt.

Die AddIn-Klasse und die ThisAddIn-Klasse

Die AddIn-Klasse stellt Basisfunktionen bereit, die alle Visual Studio Tools for Office-Add-Ins gemeinsam nutzen. Sie sollten diese Klasse jedoch nicht explizit instanziieren oder direkt im Code verwenden.

Verwenden Sie stattdessen die ThisAddIn-Klasse. Visual Studio Tools for Office generiert diese Klasse im Add-In-Projekt, die als Kommunikationsverbindung zwischen der Microsoft Office-Anwendung und dem Add-In-Code dienen soll. Die ThisAddIn-Klasse wird von AddIn abgeleitet. Visual Studio Tools for Office instanziiert diese Klasse automatisch, wenn eine Microsoft Office-Anwendung das Add-In lädt.

Die ThisAddIn-Klasse bietet einen Ausgangspunkt, um den Code im Projekt zu schreiben. Sie können auch ThisAddIn verwenden, um Aufgaben wie das Zugreifen auf das Objektmodell der Hostanwendung auszuführen. Weitere Informationen hierzu finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.

Verwenden von AddIn und ThisAddIn bei Add-In-Projekten für Outlook 2007

Add-In-Projekte für Microsoft Office Outlook 2007 verwenden mit Microsoft.Office.Tools.Outlook.OutlookAddIn ein anderes Hostelement. Diese Klasse wird von AddIn abgeleitet und fügt einige zusätzliche Funktionen hinzu, um Formularbereiche zu unterstützen. Weitere Informationen über Formularbereiche finden Sie unter Erstellen von Outlook-Formularbereichen.

Bei Add-In-Projekten für Outlook 2007 wird die ThisAddIn-Klasse von OutlookAddIn abgeleitet. Die ThisAddIn-Klasse wird bei Add-Ins für Outlook 2007 genauso verwendet wie bei Add-Ins für andere Microsoft Office-Anwendungen.

Für verschiedene Aufgaben zu verwendende Member

In der folgenden Tabelle werden häufige Aufgaben beschrieben, und es wird gezeigt, mit welchen Membern der ThisAddIn-Klasse Sie die Aufgaben ausführen können.

Aufgabe

Zu verwendender Member

Ausführen von Code zum Initialisieren des Add-Ins, wenn das Add-In geladen wird

Fügen Sie der ThisAddIn_Startup-Methode Code hinzu. Dies ist der Standardereignishandler für das Startup-Ereignis. Weitere Informationen hierzu finden Sie unter Visual Studio Tools for Office-Projektereignisse.

Ausführen von Code, um von dem Add-In verwendete Ressourcen zu bereinigen, bevor das Add-In entladen wird

Fügen Sie der ThisAddIn_Shutdown-Methode Code hinzu. Dies ist der Standardereignishandler für das Shutdown-Ereignis. Weitere Informationen hierzu finden Sie unter Visual Studio Tools for Office-Projektereignisse.

Automatisieren der Hostanwendung durch Zugriff auf das Objektmodell

Verwenden Sie das Application-Feld der ThisAddIn-Klasse. Dadurch wird eine Instanz der Application-Klasse der Anwendung zurückgegeben, mit der das Add-In funktioniert. Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.

Erstellen Sie ein Smarttag, das in allen geöffneten Word-Dokumenten oder Excel-Arbeitsmappen erkannt werden kann. Dieses Feature ist neu in Visual Studio 2008 Service Pack 1 (SP1).

Verwenden Sie das VstoSmartTags-Feld der ThisAddIn-Klasse. Dieses Feld ist nur in Add-In-Projekten für Excel 2007 und Word 2007 verfügbar, die Sie nach der Installation von SP1 erstellen. Weitere Informationen hierzu finden Sie unter Übersicht über Smarttags.

Verfügbarmachen von Objekten im Add-In für andere Microsoft Office-Projektmappen

Überschreiben Sie die RequestComAddInAutomationService-Methode. Weitere Informationen finden Sie unter Aufrufen von Code in Add-Ins auf Anwendungsebene von anderen Office-Projektmappen.

Anpassen eines Features in 2007 Microsoft Office System durch Implementieren einer Erweiterungsschnittstelle

Überschreiben Sie die RequestService-Methode, um eine Instanz einer Klasse zurückzugeben, die die Schnittstelle implementiert. Weitere Informationen hierzu finden Sie unter Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen.

Hinweis:
Um die Benutzeroberfläche der Multifunktionsleiste anzupassen, können Sie auch die CreateRibbonExtensibilityObject-Methode überschreiben.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Aufrufen von Code in einem Add-In auf Anwendungsebene von VBA

Konzepte

Programmieren von Add-Ins auf Anwendungsebene

Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit

Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen

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

Erste Schritte beim Programmieren von Add-Ins auf Anwendungsebene

Visual Studio Tools for Office-Projektereignisse

Änderungsverlauf

Date

Versionsgeschichte

Grund

Juli 2008

Informationen über das Hinzufügen von Smarttags zu Dokumenten mit Add-Ins auf Anwendungsebene hinzugefügt.

SP1-Featureänderung.