API think-cell

Su Windows è possibile programmare alcune funzioni think-cell tramite l'API think-cell. Questa appendice contiene una panoramica di tutte le funzioni API disponibili e istruzioni generali per configurare l'ambiente di sviluppo per scrivere macro, componenti aggiuntivi o programmi autonomi che accedono a queste funzioni.

Iniziare subito a utilizzare l’API think-cell

Solo Windows

L'API think-cell è integrata nel Component Object Model (COM) di Microsoft, in modo da poter accedere all'API da qualsiasi lingua con cui è possibile programmare Office, come Visual Basic for Applications (VBA) o C#.

Il punto di ingresso in think-cell è l’oggetto add-in di think-cell. È accessibile tramite la collezione Application.COMAddIns. Le chiamate a think-cell sono sempre ad associazione tardiva, quindi non c'è alcuna libreria dei tipi o alcun riferimento da aggiungere. Per una spiegazione dell’associazione precoce e tardiva in Automation, vedere Microsoft Learn.

Alcune funzioni API sono metodi dell'oggetto componente aggiuntivo think-cell in PowerPoint, mentre altre funzioni API sono metodi dell'oggetto componente aggiuntivo think-cell in Excel. Utilizziamo tcPpAddIn per i riferimenti all’add-in PowerPoint e tcXlAddIn per i riferimenti all’add-in Excel.

Visual Basic for Applications

Per scrivere macro utilizzando Visual Basic for Applications (VBA), si utilizza l'ambiente di sviluppo integrato nell'applicazione host di Office. È possibile accedervi premendo i pulsanti Alt+F11. La definizione di una macro è solitamente contenuta in un modulo, che è possibile aggiungere selezionando Insert > Module. È possibile visualizzare tutte le macro definite per un determinato documento premendo i pulsanti Alt+F8.

Per indicare che le chiamate al metodo nell’add-in think-cell sono ad associazione tardiva, è necessario dichiarare la variabile che contiene il riferimento ad esso come Object:

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

Per impostazione predefinita viene sempre fatto riferimento alla libreria dei tipi per l'applicazione host di Office. Se è necessario accedere al modello oggetto di un'altra applicazione Office, è necessario aggiungere la relativa libreria dei tipi come riferimento.

Ad esempio, se si desidera utilizzare una macro in PowerPoint per manipolare i dati in un foglio Excel prima di aggiornare think-cell chart da esso, è necessario aggiungere manualmente la Microsoft Excel 16.0 Object Library tramite la finestra di dialogo Tools > References nell'ambiente di sviluppo VBA.

Nota: 16.0 è il numero di versione di Office 2016 e versioni successive. Per Office 2013, è necessario utilizzare la libreria di oggetti 15.0. Se sono installate più versioni di Office, la finestra di dialogo References mostrerà solo le librerie di oggetti dell'ultima versione installata. Supponiamo di utilizzare Office 2016 o versioni successive.

L'utilizzo di Application.COMAddIns("thinkcell.addin").Object darà sempre l'oggetto add-in think-cell dell'attuale applicazione host di Office, ovvero tcPpAddIn o tcXlAddIn, a seconda che venga utilizzato in PowerPoint o Excel. Per acquisire un riferimento all'oggetto add-in nell'altra applicazione di Office e accedere alle funzioni API che espone, acquisirlo tramite un'istanza di applicazione appropriata.

Ad esempio, per acquisire, un riferimento a tcXlAddIn da PowerPoint:

Dim xlapp As Object
Set xlapp = New Excel.Application

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

Ricordiamo che ciò richiede l’aggiunta della libreria di oggetti di Excel come riferimento.

Si consiglia di utilizzare l'istruzione Option Explicit, che forza la dichiarazione esplicita di tutte le variabili, contribuendo così ad evitare errori di programmazione comuni e migliorando i suggerimenti forniti da IntelliSense. È possibile aggiungerla automaticamente a tutti i moduli attivando Tools > Options > Code Settings > Require Variable Declaration. Ciò è incluso in tutti i nostri esempi di codice.

C#

È possibile utilizzare l’API think-cell da C# durante lo sviluppo di add-in ed estensioni del codice del documento in esecuzione all'interno di un’applicazione host di Office, nonché durante lo sviluppo di applicazioni standalone.

Di seguito si presuppone che si stia usando Visual Studio 2017 o versioni successive per sviluppare soluzioni Office in C#. Per istruzioni di configurazione più specifiche per lo sviluppo di add-in, fare riferimento alla sezione successiva. Con ognuno dei nostri esempi di codice, indicheremo quale modello di progetto di Visual Studio utilizzare.

Per effettuare chiamate di metodo all'oggetto add-in think-cell con associazione tardiva, dichiarare la variabile contenente il riferimento all’oggetto dell’add-in think-cell come dynamic; questo è anche il tipo dedotto dal compilatore quando dichiara il riferimento come var, in modo che sia semplicemente possibile scrivere:

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

In questo caso ppapp è un riferimento a un oggetto Application PowerPoint in cui è caricato think-cell.

Per accedere al modello a oggetti di un'applicazione Office, è necessario aggiungere la libreria dei tipi o l'assembly di interoperabilità primario (PIA) come riferimento al progetto. Si consiglia di aggiungere la libreria dei tipi, se possibile, poiché Visual Studio aggiungerà automaticamente un riferimento al PIA corrispondente, se disponibile, oppure genererà un assembly di interoperabilità dalla libreria dei tipi, se non è presente (fare riferimento qui).

Ad esempio, per poter ottenere il riferimento all'oggetto add-in think-cell come in precedenza, aggiungere la Microsoft PowerPoint 16.0 Object Library che si trova nella scheda COM > Type Librariesdella finestra di dialogo Reference Manager. In base al tipo di progetto, è possibile accedere a questa finestra di dialogo facendo clic con il pulsante destro del mouse su References o Dependencies in Solution Explorer e selezionando Add (COM) Reference.

Nota: 16.0 è il numero di versione di Office 2016 e versioni successive. Utilizzando l'opzione Embed Interop Types, abilitata per impostazione predefinita per un riferimento a una libreria dei tipi COM, un'applicazione compilata con questo riferimento sarà compatibile con le versioni precedenti (e successive) con altre versioni di Office, purché tutte le interfacce utilizzate esistano nelle loro modello a oggetti. Per maggiori informazioni, fare riferimento qui.

Le funzioni API di think-cell indicano errori utilizzando COM HRESULTs. Alcuni di questi vengono mappati automaticamente sulle classi di eccezioni .NET corrispondenti: fare riferimento a Procedura: Map HRESULT ed Eccezioni.

Sviluppo di add-in

Per sviluppare add-in per Office o estensioni di codice per documenti di Office, utilizzare i modelli di progetto PowerPoint/Excel VSTO Add-in e Excel VSTO Template/Workbook. Questi fanno parte degli Office Developer Tools for Visual Studio, che vengono installati come parte della configurazione predefinita. Se questi strumenti e modelli non sono disponibili nella propria installazione di Visual Studio, è possibile aggiungerli, ad esempio, andando a Settings⚙ > Apps > Visual Studio 2022 > Modify > Other Toolsets, verificando Office/SharePoint development e facendo clic su Modify. Fare riferimento anche alla documentazione di Microsoft qui e qui.

Il PIA per l'applicazione host di Office del modello selezionato viene sempre caricato per impostazione predefinita. Se è necessario accedere al modello oggetto di un'altra applicazione Office, è necessario aggiungere la relativa libreria dei tipi come riferimento come indicato in precedenza.

Nota: l'API di think-cell non può essere utilizzata dagli add-in di Office Web (ora purtroppo chiamati semplicemente "Add-in di Office" da Microsoft) poiché non possono interagire direttamente con il modello di oggetti delle applicazioni di Office e, in particolare, non possono interagire con i componenti aggiuntivi COM come think-cell.

Riferimento API

Solo Windows

Su Windows, è possibile utilizzare le seguenti API:

• Automazione con dati Excel
• File di stile
• Grafici Mekko Graphics

Automazione con dati Excel

Aggiornare automaticamente gli elementi think-cell in un modello PowerPoint con i dati di Excel. Per ulteriori informazioni, vedere Automazione con dati Excel.

File di stile

Caricare, visualizzare e rimuovere i file di stile think-cell. Per ulteriori informazioni, vedere 🛇File di stile.

Grafici Mekko Graphics

Importare i grafici Mekko Graphics su think-cell e ispezionarli. Per ulteriori informazioni, vedere Importa grafici Mekko Graphics.