Beispiel für Laufzeitdienste

Aktualisiert: November 2007

Hinweis:
Dieses Beispiel kann nur in Microsoft Office Excel 2007 ausgeführt werden.

Dieses Beispiel zeigt, wie eine Multifunktionsleistenanpassung und ein benutzerdefinierter Aufgabenbereich für Microsoft Office Excel 2007 durch Implementieren von Erweiterbarkeitsschnittstellen in einem Add-In erstellt werden.

In diesem Beispiel werden die folgenden Erweiterbarkeitsschnittstellen zum Erstellen des benutzerdefinierten Aufgabenbereichs implementiert:

• Microsoft.Office.Core.ICustomTaskPaneConsumer. In diesem Beispiel wird diese Schnittstelle implementiert, um einen Aufgabenbereich zu erstellen, der ein Textfeld und eine Schaltfläche beinhaltet. Wenn der Benutzer auf die Schaltfläche klickt, wird die Zeichenfolge im Textfeld dem Bereich hinzugefügt, dessen Fokus auf der aktiven Arbeitsmappe liegt.

• Microsoft.Office.Core.IRibbonExtensibility. In diesem Beispiel wird diese Schnittstelle implementiert, um eine Umschaltfläche hinzuzufügen, auf die ein Benutzer klicken kann, um den Aufgabenbereich anzuzeigen oder auszublenden.

Informationen über das Installieren des Beispielprojekts auf dem Computer finden Sie unter Gewusst wie: Installieren und Verwenden von Beispieldateien in der Hilfe.

Hinweis:

Obgleich in diesem Beispiel Erweiterbarkeitsschnittstellen zum Erstellen einer Multifunktionsleistenanpassung und eines benutzerdefinierten Aufgabenbereichs verwendet werden, stellt Visual Studio Tools for Office Klassen und Designer bereit, die stattdessen verwendet werden können. Mit diesen Designern und Klassen wird das Arbeiten mit diesen Features vereinfacht. Weitere Informationen hierzu finden Sie unter Multifunktionsleisten-Designer und unter Übersicht über benutzerdefinierte Aufgabenbereiche.

Sicherheitshinweis:

Dieser Beispielcode veranschaulicht ein Konzept und zeigt nur den Code an, der für dieses Konzept relevant ist. Der Code entspricht möglicherweise nicht den Sicherheitsanforderungen bestimmter Umgebungen und sollte daher nicht in diesem Format verwendet werden. Es wird empfohlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Projekte sicherer und robuster zu gestalten. Microsoft stellt diesen Beispielcode wie besehen und ohne Garantie zur Verfügung.

Download sample

So führen Sie dieses Beispiel aus

1. Drücken Sie F5.

2. Klicken Sie auf der Multifunktionsleiste auf die Registerkarte RuntimeServices.

3. Klicken Sie in der Gruppe VSTO auf die Schaltfläche TaskPane.

   Überprüfen Sie, ob der Aufgabenbereich Contoso angezeigt wird.

4. Geben Sie im Aufgabenbereich Text in das Textfeld ein.

5. Klicken Sie auf die Schaltfläche Insert.

   Der in das Textfeld eingegebene Text muss der Zelle hinzugefügt werden, die den Fokus in der aktiven Arbeitsmappe besitzt.

6. Klicken Sie auf der Multifunktionsleiste noch einmal auf die Schaltfläche TaskPane.

   Überprüfen Sie, ob der Aufgabenbereich geschlossen wird.

Anforderungen

Für dieses Beispiel sind die folgenden Anwendungen erforderlich:

• Visual Studio Tools for Office.

• Microsoft Office Excel 2007.

Veranschaulicht

In diesem Beispiel werden die folgenden Konzepte veranschaulicht.

• Erstellen einer Multifunktionsleiste durch Implementieren der Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle in einem Add-In.

• Erstellen eines benutzerdefinierten Aufgabenbereichs durch Implementieren der Microsoft.Office.Core.ICustomTaskPaneConsumer-Schnittstelle in einem Add-In.

• Anzeigen und Ausblenden des benutzerdefinierten Aufgabenbereichs von einer Umschaltfläche auf der Multifunktionsleiste.

• Einfügen von im benutzerdefinierten Aufgabenbereich eingegebenem Text in die aktive Arbeitsmappe.

Siehe auch

Aufgaben

Demobeispiel für den Aufgabenbereich

Konzepte

Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen

Multifunktionsleisten-Designer

Übersicht über benutzerdefinierte Aufgabenbereiche

Weitere Ressourcen

Beispiele auf Dokumentebene