Adicionar um método IDL

O assistente Adicionar método IDL adiciona um método a uma interface IDL (Interface Definition Library), como em um projeto ATL que contém um arquivo IDL. Este assistente não está disponível em projetos que suportam MFC.

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

• O assistente Adicionar método adiciona um método a uma interface em seu projeto e pode atualizar a classe associada à interface.
• O assistente para Adicionar método MFC IDL é específico para projetos MFC, ActiveX ou ATL que suportam MFC.

Adicionar um método à interface IDL

1. No menu Ver, selecione Vista de Classes.

2. No painel Vista de Classe, expanda o nó do projeto para exibir a interface IDL (ficheiro .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 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 forma padrão de retornar códigos de erro de métodos definidos numa interface é com um HRESULT.

  A tabela a seguir descreve os diferentes tipos de interfaces aos quais você pode adicionar um método e o tipo de retorno permitido. Para interfaces duplas e personalizadas, o tipo de retorno deve ser HRESULT e o assistente não permitirá que você o altere.

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

• Parâmetros

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

• +

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

• x

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

• Inferir valores dos parâmetros de entrada e saída a partir dos tipos

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

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

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

• Atributos

  Os atributos a seguir também são descritos na Referência 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 usada para descrever o elemento ao qual ela se aplica. Para obter mais informações, consulte helpstring.

• Atributos adicionais

  • hidden

    Indica que o item existe, mas não deve 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 membro de um módulo, interface ou dispinterface não pode ser chamada arbitrariamente. Para obter mais informações, consulte restricted.

  • source

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

Ver também

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