API do think-cell

No Windows, você pode programar algumas funções do think-cell por meio da API do think-cell. 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 think-cell

Somente Windows

A API do think-cell é 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 think-cell é o objeto de suplemento do think-cell. Pode ser acessado através da coleção Application.COMAddIns. As chamadas ao think-cell 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 think-cell no PowerPoint, e outras, do objeto de suplemento do think-cell 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 think-cell 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 think-cell, 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 think-cell 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 think-cell 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 think-cell, declare a variável que contém a referência ao objeto do suplemento do think-cell 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 think-cell 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 think-cell 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 think-cell 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 think-cell 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 think-cell.

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 think-cell 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 think-cell. Para saber mais, consulte Arquivo de estilos.

Gráficos Mekko Graphics

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