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
No menu Exibir, selecione Modo de Exibição de Classe.
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.Clique com o botão direito do mouse no nome da interface.
No menu de atalho, selecione Adicionar>Adicionar Método.
No assistente Adicionar Método de IDL forneça as informações para criar o método.
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 decoclass
, esse atributo significa que o membro será chamado, em vez de implementado. Para obter mais informações, consultesource
.
Confira também
Adicionar um assistente de método
Adicionar um assistente de método de IDL do MFC