Compartilhar via


Personalizar o Outlook usando suplementos de COM

Creating a COM add-in involves two major steps:

  1. Implement the IDTExtensibility2 interface in a class module of a dynamic link library (DLL).
  2. Registrar o suplemento COM.

Implementar a interface IDTExtensibility2

The IDTExtensibility2 interface consists of five event procedures. To implement this interface in a Visual Basic program, set a reference to the Microsoft Add-In Designer object library and then add the following statement to the Declarations section of a class module:

Implements IDTExtensibility2

You can then add the empty event procedures to the code window of the class module and add your own program code to the procedures. You can also copy the empty procedures from an Outlook COM Add-in Template.

Registrar o suplemento COM

In order to work with Outlook, the add-in DLL must be registered. The DLL's class ID is registered beneath the \HKEY_CLASSES_ROOT subtree in the registry.

In addition, information about the add-in must be added to the registry. This information provides the add-in's name, description, target application, initial load behavior, and connection state.

Nota Se você usar o Microsoft Visual Basic 6.0 ou posterior Desenvolvedor para projetar seu suplemento COM, o designer de suplemento executará as etapas necessárias para registrar o suplemento COM para você.

The following example shows the contents of a sample registry-editor (.reg) file that illustrates how to register an Outlook COM add-in.

   [HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\SampleAddIn.AddInIFace]
    "FriendlyName"="Sample Add-in"
    "Description"="Sample Outlook Add-In"
    "LoadBehavior"=dword:00000008

Ao registrar o suplemento COM pela primeira vez, LoadBehavior pode ser definido com qualquer um dos seguintes sinalizadores.

Valor Descrição
2 Carregar na inicialização. O suplemento COM será carregado e conectado ao iniciar o Outlook.
8 Carregar sob demanda. O suplemento COM será carregado e conectado somente quando o usuário solicitá-lo, por exemplo, usando a caixa de diálogo COM Add-ins.
16 Conectar na primeira vez. O suplemento COM é carregado e conectado na primeira vez que o usuário executa o Outlook após o registro do suplemento. Na próxima execução do Outlook, o suplemento COM será carregado quando o usuário solicitá-lo. Use esse valor se o suplemento modificar a interface do usuário para permitir que ele solicite a conexão do suplemento COM sob demanda (clicando em um botão, por exemplo).

Após o registro e o carregamento do suplemento COM, será possível combinar o valor LoadBehavior com qualquer um dos dois seguintes sinalizadores para indicar o estado de conexão atual do suplemento COM.

Flag Descrição
0 Disconnected
1 Conectado

To connect the COM add-in, set the Connected flag in LoadBehavior; clear the flag to disconnect the COM add-in.

The FriendlyName value specifies the name of the COM add-in as it's displayed in the COM Add-in dialog box. The Description value provides additional information about the COM add-in.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.