API do thinkcell

No Windows, você pode programar algumas funções do thinkcell por meio da API do thinkcell. Aqui você pode encontrar uma visão geral de todas as funções de API disponíveis, e instruções gerais sobre como configurar seu ambiente de desenvolvimento para escrever macros, suplementos ou programas autônomos que acessem essas funções.

Comece a usar a API do thinkcell

Somente Windows

A API do thinkcell é integrada ao Component Object Model (COM) da Microsoft, para que você possa acessar a API em qualquer idioma com o qual possa programar o Office, como o Visual Basic for Applications (VBA) ou C#.

O ponto de entrada no thinkcell é o objeto de suplemento do thinkcell. Pode ser acessado através da coleção Application.COMAddIns. As chamadas ao thinkcell sempre são ligadas tardiamente, portanto não há biblioteca de tipos nem referências a serem adicionadas. Para obter uma explicação sobre vinculação precoce e tardia na automação, consulte o Microsoft Learn.

Algumas funções de API são métodos do objeto de suplemento do thinkcell no PowerPoint, e outras, do objeto de suplemento do thinkcell no Excel. Usaremos o tcPpAddIn para fazer referência ao suplemento do PowerPoint, e tcXlAddIn para fazer referência ao suplemento do Excel.

Visual Basic for Applications

Para escrever macros usando Visual Basic for Applications (VBA), usamos o ambiente de desenvolvimento integrado ao aplicativo host do Office. Ele pode ser acessado pressionando Alt+F11. A definição de macro geralmente está contida em um módulo, que você pode adicionar em Insert > Module. Você pode visualizar todos os macros definidos para um determinado documento pressionando Alt+F8.

Para indicar que as chamadas de método no suplemento do thinkcell são ligadas tardiamente, você precisa declarar a variável fazendo referência a isso como Object:

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

A biblioteca de tipos para o aplicativo host do Office é sempre referenciada por padrão. Caso precise acessar o modelo do objeto de outro aplicativo do Office, você deve adicionar sua biblioteca de tipos como uma referência.

Por exemplo, para usar um macro no PowerPoint para manipular dados em uma planilha do Excel antes de atualizar um gráfico do thinkcell, você deve adicionar manualmente a Microsoft Excel 16.0 Object Library através da caixa de diálogo Tools > References no ambiente de desenvolvimento de VBA.

Observação: 16.0 é o número da versão do Office 2016 e posterior. Para o Office 2013, você precisa usar a biblioteca de objetos 15.0. Se você tiver várias versões do Office instaladas, a caixa de diálogo References mostrará apenas as bibliotecas de objetos da última versão instalada. Presumiremos a seguir que você esteja usando o Office 2016 ou posterior.

Usar Application.COMAddIns("thinkcell.addin").Object sempre levará ao objeto do suplemento do thinkcell do aplicativo host do Office, ou seja, tcPpAddIn ou tcXlAddIn, dependendo de se for usado no PowerPoint ou Excel. Para adquirir uma referência ao objeto do suplemento no outro aplicativo do Office, e acesso às funções de API que ele expõe, ela deve ser adquirida através de uma instância adequada do aplicativo.

Por exemplo, para adquirir uma referência para tcXlAddIn do PowerPoint:

Dim xlapp As Object
Set xlapp = New Excel.Application

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

Observe que isso exige que a biblioteca de objetos do Excel seja adicionada como uma referência.

Recomendamos usar a declaração Option Explicit, que força a declaração explícita de todas as variáveis, dessa forma ajudando a evitar erros de programação comuns e melhorar as sugestões fornecidas pelo IntelliSense. Você pode adicioná-la automaticamente a todos os módulos ativando Tools > Options > Code Settings > Require Variable Declaration. Ela está incluída em todas as nossas amostras de código.

C#

Você pode usar a API do thinkcell a partir da C# ao desenvolver suplementos e extensões de código de documento executados dentro de um aplicativo host do Office, e ao desenvolver aplicativos autônomos.

Presumiremos a seguir que você está usando o Visual Studio 2017 ou posterior para desenvolver soluções do Office na C#. Consulte a próxima seção para obter instruções de configuração mais específicas para o desenvolvimento de suplemento. Com cada uma de nossas amostras de código, indicaremos qual modelo de projeto do Visual Studio você deve usar.

Para fazer chamadas de método à ligação tardia do objeto do suplemento do thinkcell, declare a variável que contém a referência ao objeto do suplemento do thinkcell como dynamic; esse também é o tipo inferido pelo compilador ao declarar a referência como var, então você pode simplesmente escrever:

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

Aqui, ppapp é uma referência a um objeto Application do PowerPoint, no qual o thinkcell foi carregado.

Para acessar o modelo de objeto de um aplicativo do Office, você precisa adicionar a respectiva biblioteca de tipos ou assembly de interoperabilidade principal (PIA) como uma referência ao seu projeto. Recomendamos adicionar a biblioteca de tipos se possível, pois o Visual Studio vai adicionar automaticamente uma referência à PIA correspondente, se disponível, ou gerar uma assembly de interoperabilidade da biblioteca de tipos se não houver nenhuma (consulte aqui).

Por exemplo, para conseguir obter a referência ao objeto do suplemento do thinkcell conforme indicado acima, você poderia adicionar a Microsoft PowerPoint 16.0 Object Library encontrada na guia COM > Type Libraries na caixa de diálogo Reference Manager. Dependendo do seu tipo de projeto, esta caixa de diálogo é acessada clicando com o botão direito em References ou Dependencies no Solution Explorer e selecionando Add (COM) Reference.

Observação: 16.0 é o número da versão do Office 2016 e posterior. Ao usar a opção Embed Interop Types que é habilitada por padrão para uma referência a uma biblioteca de tipos COM, uma aplicação compilada com esta referência será compatível com versões anteriores (e futuras) de outras versões do Office desde que todas as interfaces usadas existam no seu modelo de objeto. Consulte aqui para mais informações.

As funções de API do thinkcell indicam erros usando HRESULTs COM. Algumas delas são mapeadas automaticamente nas classes de exceção .NET correspondentes; consulte Como: mapear HRESULTs e exceções .

Desenvolvimento de suplementos

Para desenvolver suplementos para Office, ou extensões de código para documentos do Office, você pode usar os modelos de projeto PowerPoint/Excel VSTO Add-in e Excel VSTO Template/Workbook. Essas são uma parte das Office Developer Tools for Visual Studio, instaladas como parte da configuração padrão. Se essas ferramentas e modelos não estiverem disponíveis na sua instalação do Visual Studio, você pode adicioná-las, por exemplo, indo para Settings⚙ > Apps > Visual Studio 2022 > Modify > Other Toolsets, selecionando Office/SharePoint development e clicando em Modify. Consulte também a documentação da Microsoft aqui e aqui.

A PIA do aplicativo host do Office do modelo selecionado é sempre carregada por padrão. Caso precise acessar o modelo do objeto de outro aplicativo do Office, você deve adicionar sua biblioteca de tipos como uma referência, conforme explicado acima.

Observação: a API do thinkcell não pode ser usada nos suplementos Web do Office (infelizmente, agora simplesmente chamado de "suplementos do Office" pela Microsoft) pois não eles podem interagir diretamente com o modelo de objeto do aplicativo do Office, e não podem interagir particularmente com suplementos COM como o thinkcell.

Referência de API

Somente Windows

No Windows, você pode usar as seguintes APIs:

• Automação com dados do Excel
• Arquivo de estilos
• Gráficos Mekko Graphics

Automação com dados do Excel

Atualize automaticamente elementos thinkcell em um modelo do PowerPoint com dados do Excel. Para saber mais, consulte Automação com dados do Excel.

Arquivo de estilos

Carregue, visualize e remova arquivos de estilo do thinkcell. Para saber mais, consulte Arquivo de estilos.

Gráficos Mekko Graphics

Importe gráficos Mekko Graphics para o thinkcell e inspecione-os. Para saber mais, consulte Importar gráficos do Mekko Graphics.