Partilhar via


Implementar um ponto de conexão

Para implementar um ponto de conexão usando o Assistente para Implementação de Ponto de Conexão, você precisa ter criado um projeto como um aplicativo ATL COM ou como um aplicativo MFC que contém suporte para ATL. Use o assistente de projeto ATL para criar um aplicativo ATL ou Adicionar um objeto ATL ao aplicativo MFC para implementar o suporte à ATL para um aplicativo MFC.

Observação

Para obter informações sobre como implementar pontos de conexão para um projeto MFC, confira Pontos de conexão.

Depois de criar o projeto, para implementar um ponto de conexão, adicione primeiro um objeto ATL. Confira Adicionando objetos e controles a um projeto ATL para obter uma lista de assistentes que adicionam objetos ao projeto ATL.

Observação

O assistente não dá suporte a caixas de diálogo da ATL, serviços Web XML criados com o servidor ATL, objetos de desempenho ou contadores de desempenho.

Um objeto conectável (ou seja, uma fonte) pode mostrar um ponto de conexão para cada uma de suas interfaces de saída. Cada interface de saída pode ser implementada por um cliente em um objeto (ou seja, um coletor). Para obter mais informações, confira pontos de conexão da ATL.

Para implementar um ponto de conexão:

  1. Em Modo de Exibição de Classe, clique com o botão direito do mouse no nome da classe do objeto ATL.

  2. Selecione Adicionar no menu de atalho e, em seguida, selecione Adicionar Ponto de Conexão para exibir o assistente para implementação de ponto de conexão.

  3. Selecione as interfaces do ponto de conexão a serem implementadas nas bibliotecas de tipos apropriadas e selecione Concluir.

  4. Em Modo de Exibição de Classe, examine as classes proxy criadas para cada ponto de conexão. As classes são exibidas como CProxyInterfaceName<T> e são derivadas de IConnectionPointImpl.

  5. Clique duas vezes na classe do ponto de conexão para exibir a definição da classe do ponto de conexão.

    • Se você implementar um ponto de conexão para a interface de seu próprio projeto, a seguinte definição será exibida:

      template< class T >
      class CProxyInterfaceName :
      public IConnectionPointImpl< T, &IID_InterfaceName >
      {
      public:
      };
      
    • Se você implementar uma interface local, as propriedades e os métodos serão exibidos no corpo da classe.

    • Se você implementar um ponto de conexão para outra interface, a definição incluirá os métodos da interface, cada um precedido por Fire_.

Nesta seção

Assistente de implementação de pontos de conexão

Este assistente implementa um ponto de conexão para um objeto COM. Um objeto conectável (ou seja, uma fonte) pode mostrar um ponto de conexão para suas próprias interfaces ou para qualquer interface de saída. O MSVC e o Windows fornecem bibliotecas de tipos que têm interfaces de saída. Cada interface de saída pode ser implementada por um cliente em um objeto (ou seja, um coletor).

Para obter mais informações, confira pontos de conexão da ATL.

  • Bibliotecas de tipos disponíveis

    Exibe as bibliotecas de tipos disponíveis que guardam as definições de interface para as quais você pode implementar pontos de conexão. Selecione o botão de reticências para localizar um arquivo que tenha a biblioteca de tipos a ser usada.

  • Localidade

    Exibe o local da biblioteca de tipos atualmente selecionada na lista Bibliotecas de tipos disponíveis.

  • Interfaces

    Exibe as interfaces cujas definições estão guardadas na biblioteca de tipos atualmente selecionada na caixa Bibliotecas de tipos disponíveis.

    Botão de transferência Descrição
    > Adiciona à lista Implementar pontos de conexão o nome da interface atualmente selecionado na lista Interfaces.
    >> Adiciona à lista Implementar pontos de conexão todos os nomes de interfaces disponíveis na lista Interfaces.
    < Remove o nome da interface atualmente selecionado na lista Implementar pontos de conexão.
    << Remove todos os nomes de interfaces atualmente relacionados na lista Implementar pontos de conexão.
  • Implementar pontos de conexão

    Exibe os nomes das interfaces nas quais você implementa pontos de conexão quando seleciona Concluir.