Implementar uma interface

Para implementar uma interface, 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.

Depois de criar o projeto, para implementar uma interface, adicione primeiro um objeto ATL. Confira Adicionar 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 que usam a ATL, objetos de desempenho ou contadores de desempenho.

Se você adicionar um controle da ATL, poderá especificar se deseja implementar interfaces padrão. As interfaces padrão são listadas na página Interfaces do assistente e definidas em atlcom.h.

Depois de adicionar o objeto ou o controle, implemente outras interfaces, localizadas em qualquer biblioteca de tipos disponível, usando o Assistente para Implementação de Interface.

Caso esteja adicionando uma nova interface, adicione-a manualmente ao arquivo .idl do projeto. Para obter mais informações, confira Adicionar uma nova interface a um projeto ATL.

Para implementar uma interface:

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 Implementar Interface para exibir o assistente para implementação de interface.

3. Selecione as interfaces a serem implementadas nas bibliotecas de tipos apropriadas e selecione Concluir.

4. No Modo de Exibição de Classe, expanda o nó Bases e Interfaces para ver a interface que implementou. Em seguida, expanda o nó da interface para ver as propriedades, métodos e eventos disponíveis.

   Observação

   Use também o Pesquisador de Objetos para examinar os membros da interface.

Nesta seção

• Assistente de implementação de interface

Assistente de implementação de interface

Este assistente implementa uma interface para um objeto COM. As implementações de muitas interfaces estão incluídas nas bibliotecas COM disponíveis no Visual Studio e no Windows. Uma implementação de interface é associada a um objeto quando uma instância do objeto é criada. Ela também informa os serviços que o objeto oferece.

Para ver uma discussão sobre interfaces e implementações, confira Interfaces e implementações de interface no SDK do Windows.

• Implementar interface de

  Especifica o local da biblioteca de tipos, com base na qual a interface é criada.

  Opção	Descrição
  Projeto	A biblioteca de tipos faz parte do projeto.
  Registro	A biblioteca de tipos é registrada no sistema. As bibliotecas de tipos registradas são listadas em Bibliotecas de tipos disponíveis.
  Arquivo	A biblioteca de tipos não está necessariamente registrada no sistema, mas está guardada em um arquivo. Forneça a localização do arquivo em Localização.

• Bibliotecas de tipos disponíveis

  Exibe as bibliotecas de tipos disponíveis que guardam as definições de interface que você pode implementar. Se você escolher Arquivo em Implementar interface de, essa caixa não ficará disponível para alteração.

• Localidade

  Exibe o local da biblioteca de tipos atualmente selecionada na lista Bibliotecas de tipos disponíveis. Se você tiver selecionado Arquivo em Implementar interface de, selecione o botão de reticências para localizar um arquivo que guarda a biblioteca de tipos a ser usada.

• Interfaces

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

  Observação

  As interfaces que têm o mesmo nome daquelas já implementadas pelo objeto selecionado não são exibidas na caixa Interfaces.

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

• Implementar Interfaces

  Exibe os nomes das interfaces selecionadas para implementação no objeto.

  Observação

  Se você incluir mais de uma interface derivada de IDispatch ou se tentar implementar uma interface derivada de outra interface que já está na classe, precisará desfazer a ambiguidade das entradas COM_MAP. Para obter mais informações, confira COM_INTERFACE_ENTRY2.