think-cell API

Unter Windows können Sie einige think-cell Funktionen über die think-cell API programmieren. Dieser Anhang enthält einen Überblick über alle verfügbaren API-Funktionen und allgemeine Hinweise, wie Sie Ihre Entwicklungsumgebung einrichten, um Makros, Add-ins oder eigenständige Programme zu schreiben, die auf diese Funktionen zugreifen.

Erste Schritte mit der think-cell API

Nur Windows

Die think-cell API ist in das Component Object Model (COM) von Microsoft integriert, sodass Sie von jeder Sprache, mit der Sie Office programmieren können, wie beispielsweise Visual Basic for Applications (VBA) oder C#, auf die API zugreifen können.

Der Einstiegspunkt in think-cell ist das think-cell Add-In-Objekt. Dieses kann über die Application.COMAddIns-Sammlung aufgerufen werden. Aufrufe in think-cell sind immer spät gebunden, daher muss keine Typenbibliothek oder Referenz hinzugefügt werden. Eine Erklärung der frühen und späten Bindung in Automation finden Sie unter Microsoft Learn.

Einige API-Funktionen sind Methoden des think-cell Add-in-Objekts in Microsoft PowerPoint, und andere API-Funktionen sind Methoden des think-cell Add-in-Objekts in Excel. Wir verwenden tcPpAddIn für Referenzen zum PowerPoint Add-in und tcXlAddIn für Referenzen zum Excel Add-in.

Visual Basic for Applications

Um Makros mithilfe von Visual Basic for Applications (VBA) zu schreiben, verwenden Sie die Entwicklungsumgebung, die in die Office Host-Anwendung integriert ist. Diese kann durch Drücken von Alt+F11 aufgerufen werden. Die Definition eines Makros ist für gewöhnlich in einem Modul enthalten, das Sie über Insert > Module hinzufügen können. Sie können alle Makros, die für ein bestimmtes Dokument definiert wurden, aufrufen, indem Sie Alt+F8 drücken.

Um anzuzeigen, dass Methodenaufrufe zum think-cell Add-In spät gebunden sind, müssen Sie die Variable, die die Referenz dazu enthält, wie folgt deklarieren: Object

Dim tcaddin As Object 
Set tcaddin = Application.COMAddIns("thinkcell.addin").Object

Die Typenbibliothek für die Office Host-Anwendung wird immer standardmäßig referenziert. Wenn Sie das Objektmodell einer anderen Office-Anwendung aufrufen müssen, müssen Sie dessen Typenbibliothek als Referenz hinzufügen.

Wenn Sie zum Beispiel ein Makro in PowerPoint einsetzen wollen, um Daten in einer Excel-Tabelle zu bearbeiten, bevor Sie ein think-cell Diagramm daraus aktualisieren, müssen Sie das Microsoft Excel 16.0 Object Library manuell über den Dialog Tools > References in der VBA-Entwicklungsumgebung hinzufügen.

Hinweis: 16.0 ist die Versionsnummer von Office 2016 und späteren Versionen. Für Office 2013 müssen Sie die Objekt Library 15.0 verwenden. Wenn Sie mehrere Versionen von Office installiert haben, zeigt der Dialog References nur die Objektverzeichnisse der neuesten installierten Version an. Wir gehen im Folgenden davon aus, dass Sie Office 2016 oder eine neuere Version verwenden.

Durch Verwenden von Application.COMAddIns("thinkcell.addin").Object erhalten Sie immer das think-cell Add-In-Objekt der aktuellen Office Host-Anwendung, d. h. tcPpAddIn oder tcXlAddIn, je nachdem, ob Sie es in PowerPoint oder Excel verwenden. Um eine Referenz zum Add-In-Objekt in der anderen Office-Anwendung zu erhalten und die exponierten API-Funktionen aufzurufen, müssen Sie es durch eine angemessene Anwendungsinstanz beschaffen.

Um zum Beispiel eine Referenz zu tcXlAddIn von PowerPoint zu erhalten:

Dim xlapp As Object
Set xlapp = New Excel.Application

Dim tcXlAddIn As Object
Set tcXlAddIn = xlapp.COMAddIns("thinkcell.addin").Object

Bitte beachten Sie, dass das Excel Objektverzeichnis als Referenz hinzugefügt werden muss.

Wir empfehlen, die Option Explicit Aussage zu verwenden, die die explizite Deklarierung aller Variablen erzwingt, wodurch häufige Programmierfehler vermieden und Vorschläge von IntelliSense verbessert werden. Sie können sie automatisch zu allen Modulen hinzufügen lassen, wenn Sie Tools > Options > Code Settings > Require Variable Declaration aktivieren. Sie ist in all unseren Codebeispielen enthalten.

C#

Sie können die think-cell API von C# beim Entwickeln von Ad-Ins verwenden und Codeerweiterungen, die in einer Office Host-Anwendung ausgeführt werden, dokumentieren. Gleiches gilt für das Entwickeln alleinstehender Anwendungen.

Wir gehen im Folgenden davon aus, dass Sie Visual Studio 2017 oder eine neuere Lösung verwenden, um Office Lösungen in C# zu entwickeln. Um nächsten Abschnitt finden Sie spezifischere Set-up-Anweisungen für die Add-In-Entwicklung. Wir geben bei jedem unserer Codebeispiele an, welche Visual Studio Projektvorlage verwendet werden soll.

Um spät gebundene Methodenaufrufe zum think-cell Add-In-Objekt zu tätigen, deklarieren Sie die Variable, die die Referenz zum think-cell Add-In-Objekt enthält, als dynamic. Dies ist auch der vom Compiler gefolgerte Typ, wenn die Referenz als var deklariert wird. Daher können Sie einfach Folgendes schreiben:

var tcPpAddIn = ppapp.COMAddIns.Item("thinkcell.addin").Object;

Hier ist ppapp eine Referenz auf ein PowerPoint Application Objekt, in dem think-cell geladen wird.

Um das Objektmodell einer Office-Anwendung aufzurufen, müssen Sie entweder seine Typenbibliothek oder seine primäre Interop-Assembly (PIA) als Referenz zu Ihrem Projekt hinzufügen. Wir empfehlen, wenn möglich die Typenbibliothek hinzuzufügen, da Visual Studio automatisch eine Referenz zur entsprechenden PIA hinzufügt, falls verfügbar, oder eine Interop-Assembly aus der Typenbibliothek erstellt, wenn es keine gibt (siehe hier).

Um zum Beispiel die Referenz zum think-cell Add-In-Objekt wie oben zu erhalten, fügen Sie das Microsoft PowerPoint 16.0 Object Library aus der Registerkarte COM > Type Libraries des Dialogs Reference Manager hinzu. Je nach Projekttyp wird der Dialog entweder durch Rechtsklick auf References oder Dependencies im Solution Explorer und Auswahl von Add (COM) Reference aufgerufen.

Hinweis: 16.0 ist die Versionsnummer von Office 2016 und späteren Versionen. Durch Nutzen der Option Embed Interop Types, die standardmäßig für eine Referenz zur COM-Typenbibliothek aktiviert wird, wird eine mit dieser Referenz zusammengestellte Anwendung rückwärts (und vorwärts) mit anderen Office Versionen kompatibel sein, solange alle verwendeten Schnittstellen in ihrem Objektmodell existieren. Weitere Informationen finden Sie hier.

Die API-Funktionen von think-cell geben Fehler beim Verwenden von COM HRESULT an. Einige davon werden automatisch in entsprechenden -NET Ausnahmeklassen dargestellt. Siehe Anleitung: HRESULTs und Ausnahmen darstellen .

Add-in-Entwicklung

Um Add-Ins für Office oder Code-Erweiterungen für Office-Dokumente zu entwickeln, verwenden Sie PowerPoint/Excel VSTO Add-in und Excel VSTO Template/Workbook Projektvorlagen. Diese gehören zu den Office Developer Tools for Visual Studio die in dieser Standardkonfiguration installiert sind. Sollten diese Tools und Vorlagen in Ihrer Visual Studio Installation nicht verfügbar sein, können Sie sie beispielsweise hinzufügen, indem Sie zu Settings⚙ > Apps > Visual Studio 2022 > Modify > Other Toolsets gehen, Office/SharePoint development aktivieren und Modify anklicken. Siehe auch Dokumentation von Microsoft hier und hier.

Die PIA für die Office Host-Anwendung der ausgewählten Vorlage wird immer standardmäßig geladen. Wenn Sie auf das Objektmodell einer anderen Office-Anwendung zugreifen müssen, müssen Sie wie oben erklärt die Typenbibliothek als Referenz hinzufügen.

Hinweis: think-cells API kann nicht von Office aus verwendet werden Web Add-Ins – von Microsoft leider nur noch Office-Add-Ins genannt – können nicht direkt mit dem Objektmodell der Office-Anwendungen interagieren und insbesondere nicht mit COM-Add-Ins wie think-cell.

API-Referenz

Nur Windows

Unter Windows können Sie die folgenden APIs verwenden:

• Automatisierung mit Excel-Daten
• Stildefinitionen
• Mekko Graphics-Diagramme

Automatisierung mit Excel-Daten

Automatische Aktualisierung von think-cell Elementen in einer PowerPoint-Vorlage mit Daten aus Excel. Unter Automatisierung mit Excel-Daten erfahren Sie mehr.

Stildefinitionen

Laden, Anzeigen und Entfernen von think-cell Stildefinitionen. Unter 🛇Stildefinitionen erfahren Sie mehr.

Mekko Graphics-Diagramme

Importieren Sie Mekko Graphics-Diagramme in think-cell, und untersuchen Sie sie. Unter Mekko Graphics-Diagramme importieren erfahren Sie mehr.