Adicionar um método de IDL

O assistente Adicionar Método de IDL adiciona um método a uma interface de IDL (Biblioteca de Definição de Interface), como em um projeto de ATL que contém um arquivo IDL. Este assistente não está disponível em projetos que dão suporte a MFC.

Esse assistente difere do assistente Adicionar método e do assistente Adicionar método de IDL do MFC das seguintes maneiras:

• O assistente Adicionar método adiciona um método a uma interface no projeto e pode atualizar a classe associada à interface.
• O assistente Adicionar método de IDL do MFC é específico para projetos do MFC, ActiveX ou ATL que dão suporte a MFC.

Adicionar um método à interface IDL

1. No menu Exibir, selecione Modo de Exibição de Classe.

2. No painel Modo de Exibição de Classe expanda o nó do projeto para exibir a interface IDL (arquivo .idl) à qual você deseja adicionar o método.

3. Clique com o botão direito do mouse no nome da interface.

4. No menu de atalho, selecione Adicionar>Adicionar Método.

5. No assistente Adicionar Método de IDL forneça as informações para criar o método.

6. Selecione OK para adicionar o método.

Lista de elementos da interface do usuário

A seção a seguir descreve a interface do assistente que você usará para adicionar um método:

• Nome do método

  Forneça um nome para o método.

• Tipo de retorno

  O tipo de dados retornado pelo método. A maneira padrão de retornar códigos de erro de métodos definidos em uma interface é com um HRESULT.

  A tabela a seguir descreve os diferentes tipos de interfaces às quais é possível adicionar um método e o tipo de retorno permitido. Para interfaces duplas e personalizadas, o tipo de retorno deverá ser HRESULT e o assistente não permitirá que seja alterado.

  Tipo de interface	Tipo de retorno
  Interface dupla	HRESULT. Inalterável.
  Interface personalizada	HRESULT. Inalterável.
  Interface personalizada local	Forneça seu próprio tipo de devolução ou selecione-o na lista suspensa.
  Dispinterface	Forneça seu próprio tipo de devolução ou selecione-o na lista suspensa.

• Parâmetros

  Exibe os parâmetros, os modificadores e os tipos do método.

• +

  Adicione um parâmetro. Em Parâmetros, digite o tipo de parâmetro, o nome e os modificadores. Por exemplo, [in] int i, e escolha OK.

• x

  Remove o parâmetro selecionado da lista Parâmetros.

• Inferir valores de parâmetros de entrada/saída dos tipos

  Insere o atributo [in] ou [out] com base no tipo do parâmetro.

• Defina o último parâmetro como o valor retornado (retval)

  O último parâmetro será tratado como o valor retornado do método.

• Atributos

  Os atributos a seguir também são descritos na Referência de MIDL.

  • id

    Define a ID numérica que identifica o método. Para obter mais informações, consulte id.

  • call_as

    Especifica o nome do método remoto a ser mapeado para esse método local. Para obter mais informações, consulte call_as.

  • helpcontext

    Especifica uma ID de contexto que permite ao usuário exibir informações sobre esse método no arquivo de Ajuda. Para obter mais informações, consulte helpcontext.

  • helpstring

    Especifica a cadeia de caracteres utilizada para descrever o elemento ao qual se aplica. Para obter mais informações, consulte helpstring.

• Atributos adicionais

  • hidden

    Indica que o item existe, mas não deveria ser exibido em um navegador orientado ao usuário. Para obter mais informações, consulte hidden.

  • local

    Especifica que uma interface ou função não é remota. Para obter mais informações, consulte local.

  • restricted

    Especifica que uma biblioteca ou um membro de um módulo, interface ou dispinterface não pode ser chamado arbitrariamente. Para obter mais informações, consulte restricted.

  • source

    Indica que um membro de coclass, propriedade ou método é uma fonte de eventos. Para um membro de coclass, esse atributo significa que o membro será chamado, em vez de implementado. Para obter mais informações, consulte source.

Confira também

Adicionar um assistente de método
Adicionar um assistente de método de IDL do MFC