Suplementos do Excel COM e suplementos de Automação

Suplementos COM

Os suplementos COM apresentam ao desenvolvedor uma maneira de estender a funcionalidade de aplicativos do Office para tarefas personalizadas. Suplementos COM normalmente são usados para automatizar o Excel em resposta a um clique de um botão CommandBar, uma caixa de diálogo ou formulário ou algum outro evento específico do Excel, como abrir ou fechar pastas de trabalho ou inserir dados em planilhas. As funções de suplemento COM não podem ser chamadas diretamente de fórmulas de célula em planilhas.

Um Suplemento COM é um servidor COM em processo (uma DLL ActiveX) que deve implementar a interface IDTExensibility2. Todos os suplementos COM devem implementar cada um dos cinco métodos dessa interface: OnConnection, OnStartupComplete, OnAddinsUpdate, OnBeginShutDown e OnDisconnection.

Quando um Suplemento COM é instalado no sistema de um usuário, as entradas do registro são criadas para o Suplemento. Além do registro COM normal, um Suplemento COM é registrado para cada aplicativo do Office no qual ele é executado. Os suplementos COM usados pelo Excel são registrados na seguinte chave do registro:

            
HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\ 

Essa chave contém uma subchave para cada suplemento COM instalado. O nome da subchave é o ProgID para o Suplemento COM. A subchave para um Suplemento COM também contém valores que descrevem o nome amigável, a descrição e o comportamento de carga do Suplemento COM. O comportamento de carga descreve como o Suplemento é carregado no Excel: carregado na inicialização, carregado somente na próxima inicialização, carregado sob demanda ou não carregado.

Os suplementos COM também podem ser carregados e descarregados por meio da interface do usuário do Excel. Para fazer isso, siga estas etapas:

1. No menu Exibir, aponte para barras de ferramentas e clique em Personalizar.

2. Na caixa de diálogo Barras de Ferramentas, clique na guia Avançado. Na lista de categorias, selecione Ferramentas. Localize suplementos COM na lista de comandos e arraste o comando para um menu ou CommandBar de sua escolha. Feche a caixa de diálogo Barras de Ferramentas.

3. Clique no comando Suplementos COM que você adicionou para exibir a caixa de diálogo Suplementos COM. A caixa de diálogo lista todos os suplementos COM instalados em seu sistema e os suplementos COM carregados no momento estão selecionados.

Os suplementos COM também podem ser carregados e descarregados por meio da interface do usuário do Excel. Para fazer isto, siga estas etapas:

1. Clique no Botão do Microsoft Office e clique em Opções do Excel.

2. Clique em Suplementos.

3. Em Gerenciar, clique em Adicionar ins com e clique em Ir .
   
   A caixa de diálogo Suplementos COM lista todos os suplementos COM instalados no computador. Os suplementos COM que estão carregados no momento são selecionados.

Para obter mais informações, confira o seguinte site da Microsoft:

Visão geral da plataforma de suplementos do Office

Suplementos de automação

Além dos suplementos COM, o Excel dá suporte a suplementos de automação. Os suplementos de automação se baseiam em suplementos COM em que as funções em Suplementos de Automação podem ser chamados de fórmulas nas planilhas do Excel. Os suplementos COM devem ser servidores COM em processo que dão suporte à interface IDTExtensibility2; no entanto, os Suplementos de Automação podem ser servidores COM em processo ou fora de processo e a implementação do IDTExtensibility2 é opcional.

Para usar funções de um Suplemento de Automação no Excel, siga estas etapas:

1. No menu Ferramentas, clique em Suplementos.

2. Na caixa de diálogo Add-Ins, clique em Automação. Na lista de servidores COM registrados, selecione seu Suplemento de Automação e clique em OK.

3. O Suplemento de Automação é exibido na caixa de diálogo Suplementos. Clique em OK para fechar a caixa de diálogo Add-Ins.

Para usar funções de um Suplemento de Automação no Excel 2007 e mais recente, siga estas etapas:

1. Clique no Botão do Microsoft Office e clique em Opções do Excel.

2. Clique em Suplementos.

3. Em Gerenciar, clique em Adicionar ins do Excel e clique em Ir.

4. Na caixa de diálogo Suplementos , clique em Automação. Na lista de servidores COM registrados, clique em seu Suplemento de Automação e clique em OK.
   
   O Suplemento de Automação é exibido na caixa de diálogo Suplementos . Clique em OK para fechar a caixa de diálogo Suplementos .

Quando você faz adições à lista na caixa de diálogo Add-Ins ou quando seleciona e limpa suplementos na lista, o Excel armazena suas alterações no registro. Primeiro, o Excel usa a seguinte configuração de registro para determinar se um Suplemento de Automação na lista de suplementos está carregado ou não:

 Excel 2002
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

 Excel 2003
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"
Excel 2007
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

Observação: altere o número da versão do Office com base na versão que você está usando.


O comutador /A usado no valor da cadeia de caracteres é novo no Excel e mais antigo e é usado especificamente para carregar suplementos de automação. Todos os suplementos de automação são carregados sob demanda; não há nenhuma configuração que possa alterar o comportamento de carga de um Suplemento de Automação.

Quando um Suplemento de Automação listado na caixa de diálogo Add-Ins é desmarcado, uma subchave com um nome igual ao ProgID do Suplemento é criada na seguinte chave do registro:

HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Add-in Manager Excel 2003:



HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager
HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager Essa configuração de registro garante que os Suplementos de Automação que você adicionou à lista de suplementos sejam mantidos na lista mesmo quando você optou por não carregá-los.

Para obter mais informações, confira o seguinte site da Microsoft:

Visão geral da plataforma de suplementos do Office

Suplementos de automação que implementam IDTExtensibility2

Como mencionado anteriormente, um Suplemento de Automação pode implementar iDTExtensibility2, mas não é necessário para que o Excel chame as funções no Suplemento de uma planilha. Se você exigir que seu Suplemento de Automação obtenha uma referência à instância do Excel, você poderá implementar IDTExtensibility2 e usar o parâmetro De aplicativo do OnConnection para automatizar o Excel.

Um Suplemento de Automação que implementa
IDTExtensibility2 pode ser carregado na interface do usuário do Excel por meio da caixa de diálogo COM Add-Ins e da caixa de diálogo Add-Ins. A seguir, descreve o comportamento de um Suplemento de Automação com base em se ele é carregado em uma ou em ambas as caixas de diálogo:

• Carregado somente na caixa de diálogo Suplementos.
  
  O Suplemento é carregado sob demanda. As funções no Suplemento podem ser chamadas de fórmulas em uma planilha.

• Carregado somente na caixa de diálogo Suplementos COM.
  
  O Suplemento é carregado como um Suplemento COM e seu comportamento de carga é determinado a partir de configurações no registro. As funções no Suplemento não podem ser chamadas de fórmulas em uma planilha.

• Carregado na caixa de diálogo Suplementos COM e na caixa de diálogo Suplementos.
  
  Duas instâncias separadas do Suplemento são carregadas. Uma instância é carregada como um suplemento COM e a outra instância é carregada como um Suplemento de Automação. A instância de suplemento COM usa o comportamento de carga indicado no registro; a instância de Suplemento de Automação é carregada sob demanda. As duas instâncias funcionam independentemente uma da outra e não compartilham variáveis globais.

Como os Suplementos de Automação são carregados sob demanda, o Excel pode tentar carregar o Suplemento enquanto ele está no modo de edição de célula. Portanto, quando você desenvolve um Suplemento de Automação que dá suporte a IDTExtensibility2, você deve ter cuidado para não fazer nada que tente alterar o estado do Excel enquanto o Suplemento é carregado. Para obter mais informações, consulte o seguinte artigo na Base de Dados de Conhecimento Microsoft:

284876 BUG: o Excel falha quando a automação Add-In carrega

(c) Microsoft Corporation 2001, Todos os direitos reservados. Contribuições de Lori B. Turner, Microsoft Corporation.