Partilhar via

Implementar uma interface

Para implementar uma interface, você deve ter criado um projeto como um aplicativo ATL COM ou como um aplicativo MFC que contém suporte ATL. Você pode usar o assistente de projeto ATL para criar um aplicativo ATL ou adicionar um objeto ATL ao seu aplicativo MFC para implementar o suporte ATL para um aplicativo MFC.

Depois de criar o projeto, para implementar uma interface, você deve primeiro adicionar um objeto ATL. Consulte Adicionar objetos e controles a um projeto ATL para obter uma lista de assistentes que adicionam objetos ao seu projeto ATL.

Observação

O assistente não suporta caixas de diálogo ATL, serviços Web XML usando ATL, objetos de desempenho ou contadores de desempenho.

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

Depois de adicionar o objeto ou controle, você pode implementar outras interfaces, localizadas em qualquer biblioteca de tipos disponível, usando o Assistente para Implementar Interface.

Se você estiver adicionando uma nova interface, deverá adicioná-la manualmente ao arquivo .idl do projeto. Para obter mais informações, consulte Adicionar uma nova interface em um projeto ATL.

Para implementar uma interface:

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

  2. Escolha Adicionar no menu de atalho e, em seguida, escolha Implementar interface para exibir o assistente de interface de implementação.

  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 do objeto para ver a interface que você implementou. Em seguida, expanda o nó da interface para ver as suas propriedades, métodos e eventos disponíveis.

    Observação

    Você também pode usar o navegador de objetos para examinar os membros da interface.

Nesta secção

Assistente de implementação de interface

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

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

  • Implementar interface a partir de

    Especifica o local da biblioteca de tipos, a partir da qual a interface é criada.

    Opção Descrição
    Projeto A biblioteca de tipos faz parte do projeto.
    Registo A biblioteca de tipos está registada no sistema. As bibliotecas de tipos registrados são listadas em Bibliotecas de tipos disponíveis.
    Ficheiro A biblioteca de tipos não é necessariamente registrada no sistema, mas é mantida em um arquivo. Forneça o local do arquivo em Local.

  • Bibliotecas de tipos disponíveis

    Exibe as bibliotecas de tipos disponíveis que contêm as definições de interface que você pode implementar. Se escolher Ficheiro em Implementar interface de, esta caixa não poderá ser alterada.

  • Localização

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

  • Interfaces

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

    Observação

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

    Botão Transferir Descrição
    > Adiciona à lista Implementar interfaces o nome da interface selecionada atualmente 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 interface atualmente listados na lista Implementar interfaces .

  • Implementar interfaces

    Exibe os nomes das interfaces que você selecionou para implementar em seu objeto.

    Observação

    Se você incluir mais de uma interface derivada de IDispatch, ou se tentar implementar uma interface derivada de outra interface já em sua classe, deverá desambiguar as entradas COM_MAP. Para obter mais informações, consulte COM_INTERFACE_ENTRY2.

  • Last updated on