Suplementos e suplementos de Automatização do Excel COM

Suplementos COM

Os Suplementos COM apresentam ao programador uma forma de expandir a funcionalidade das aplicações do Office para tarefas personalizadas. Os Suplementos COM são normalmente utilizados para automatizar o Excel em resposta a um clique de um botão da Barra de Comandos, a um formulário ou caixa de diálogo ou a outro evento específico do Excel, como abrir ou fechar livros ou introduzir dados em folhas de cálculo. As funções de Suplemento COM não podem ser chamadas diretamente a partir de fórmulas de células em folhas de cálculo.

Um Suplemento COM é um servidor COM em processo (um DLL ActiveX) que tem de implementar a interface IDTExensibility2. Todos os Suplementos COM têm de implementar cada um dos cinco métodos desta interface: OnConnection, OnStartupComplete, OnAddinsUpdate, OnBeginShutDown e OnDisconnection.

Quando um Suplemento COM é instalado no sistema de um utilizador, são criadas entradas de registo para o Suplemento. Além do registo COM normal, é registado um Suplemento COM para cada aplicação do Office em que é executado. Os suplementos COM utilizados pelo Excel estão registados na seguinte chave de registo:

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

Esta chave contém uma subchave para cada Suplemento COM instalado. O nome da subchave é ProgID para o Suplemento COM. A subchave de um Suplemento COM também contém valores que descrevem o nome amigável, a descrição e o comportamento de carregamento do Suplemento COM. O comportamento de carga descreve como o Suplemento é carregado no Excel: carregado no arranque, carregado apenas no arranque seguinte, carregado a pedido ou não carregado.

Os suplementos COM também podem ser carregados e descarregados através da interface de utilizador do Excel. Para tal, siga estes passos:

1. No menu Ver, aponte para Barras de Ferramentas e, em seguida, clique em Personalizar.

2. Na caixa de diálogo Barras de Ferramentas, clique no separador Avançadas. Na lista de categorias, selecione Ferramentas. Localize Suplementos COM na lista de comandos e arraste o comando para um menu ou Barra de Comandos à sua escolha. Feche a caixa de diálogo Barras de Ferramentas.

3. Clique no comando Suplementos COM que adicionou para apresentar a caixa de diálogo Suplementos COM. A caixa de diálogo lista todos os Suplementos COM que estão instalados no seu sistema e os Suplementos COM que estão atualmente carregados estão selecionados.

Os suplementos COM também podem ser carregados e descarregados através da interface de utilizador do Excel. Para tal, siga estes passos:

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

2. Clique em Suplementos.

3. Em Gerir, clique em Suplementos COM e, em seguida, clique em Ir .
   
   A caixa de diálogo Suplementos COM lista todos os suplementos COM que estão instalados no computador. Os suplementos COM atualmente carregados estão selecionados.

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

Descrição geral da plataforma de Suplementos do Office

Suplementos de Automatização

Além dos Suplementos COM, o Excel suporta Suplementos de Automatização. Os Suplementos de Automatização baseiam-se em Suplementos COM nessas funções nos Suplementos de Automatização que podem ser chamados a partir de fórmulas em folhas de cálculo do Excel. Os suplementos COM têm de ser servidores COM em processo que suportem a interface IDTExtensibility2; No entanto, os Suplementos de Automatização podem estar em processamento ou servidores COM fora do processo e a implementação de IDTExtensibility2 é opcional.

Para utilizar funções de um Suplemento de Automatização no Excel, siga estes passos:

1. No menu Ferramentas, clique em Suplementos.

2. Na caixa de diálogo Add-Ins, clique em Automatização. Na lista de servidores COM registados, selecione o suplemento automatização e clique em OK.

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

Para utilizar funções de um Suplemento de Automatização no Excel 2007 e mais recentes, siga estes passos:

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

2. Clique em Suplementos.

3. Em Gerir, clique em Suplementos do Excel e, em seguida, clique em Ir.

4. Na caixa de diálogo Suplementos , clique em Automatização. Na lista de servidores COM registados, clique no Suplemento de Automatização e, em seguida, clique em OK.
   
   O Suplemento de Automatização é apresentado na caixa de diálogo Suplementos . Clique em OK para fechar a caixa de diálogo Suplementos .

Quando faz adições à lista na caixa de diálogo Add-Ins ou quando seleciona e desmarca suplementos na lista, o Excel armazena as alterações no registo. Em primeiro lugar, o Excel utiliza a seguinte definição de registo para determinar se um Suplemento de Automatização na lista de Suplementos está ou não carregado:

 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"

Nota: altere o número da versão do Office com base na versão que está a utilizar.


O parâmetro /A utilizado no valor da cadeia é novo no Excel e mais antigo e é utilizado especificamente para carregar Suplementos de Automatização. Todos os Suplementos de Automatização são carregados a pedido; não existe nenhuma definição que possa alterar o comportamento de carga de um Suplemento de Automatização.

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

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 Esta definição de registo garante que os Suplementos de Automatização que adicionou à lista de Suplementos são mantidos na lista mesmo quando optou por não os carregar.

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

Descrição geral da plataforma de Suplementos do Office

Suplementos de Automatização que Implementam IDTExtensibility2

Conforme mencionado anteriormente, um Suplemento de Automatização pode implementar IDTExtensibility2, mas não é necessário para que o Excel chame as funções no Suplemento a partir de uma folha de cálculo. Se precisar que o Suplemento de Automatização obtenha uma referência para a instância do Excel, pode implementar IDTExtensibility2 e utilizar o parâmetro Aplicação de OnConnection para automatizar o Excel.

Um Suplemento de Automatização que implementa
O IDTExtensibility2 pode ser carregado na interface de utilizador do Excel através da caixa de diálogo COM Add-Ins e da caixa de diálogo Add-Ins. O seguinte descreve o comportamento de um Suplemento de Automatização com base no facto de ser carregado numa ou em ambas as caixas de diálogo:

• Carregado apenas na caixa de diálogo Suplementos.
  
  O Suplemento é carregado a pedido. As funções no Suplemento podem ser chamadas a partir de fórmulas numa folha de cálculo.

• Carregado apenas na caixa de diálogo Suplementos COM.
  
  O Suplemento é carregado como um Suplemento COM e o respetivo comportamento de carga é determinado a partir das definições no registo. As funções no Suplemento não podem ser chamadas a partir de fórmulas numa folha de cálculo.

• Carregado na caixa de diálogo Suplementos COM e na caixa de diálogo Suplementos.
  
  São carregadas duas instâncias separadas do Suplemento. Uma instância é carregada como um Suplemento COM e a outra instância é carregada como um Suplemento de Automatização. A instância do Suplemento COM utiliza o comportamento de carga indicado no registo; a instância do Suplemento de Automatização é carregada a pedido. As duas instâncias funcionam independentemente umas das outras e não partilham variáveis globais.

Uma vez que os Suplementos de Automatização são carregados a pedido, o Excel pode tentar carregar o Suplemento enquanto está no modo de edição de células. Por conseguinte, quando desenvolver um Suplemento de Automatização que suporte IDTExtensibility2, deve ter o cuidado de não fazer nada que tente alterar o estado do Excel enquanto o Suplemento é carregado. Para obter mais informações, consulte o artigo seguinte na Base de Dados de Conhecimento Microsoft:

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

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