Adicionar um método IDL MFC

O assistente Add IDL MFC Method adiciona um método a uma interface da Interface Definition Library (IDL) definida no seu projeto Microsoft Framework Class (MFC). Se o projeto contiver uma classe associada à interface, o assistente também adiciona o método à classe.

Para usar este assistente, deve estar num Projeto MFC, ActiveX ou ATL que suporte MFC. Por exemplo, se tiver um projeto de controlo Microsoft ActiveX, pode usar o seguinte procedimento para adicionar um método a uma interface IDL na solução.

Este assistente difere do assistente de Adicionar Método (que adiciona um método a uma interface IDL) das seguintes formas:

• É específico para projetos MFC, ActiveX ou ATL que suportam MFC. Para projetos ATL que não suportam MFC, apenas o assistente de Adicionar Método está disponível.

• Adiciona as seguintes entradas se for encontrado um mapa de Despacho no projeto:

  BEGIN_DISPATCH_MAP(CMFCApplication2Doc, CDocument)
      DISP_FUNCTION_ID(CMFCApplication2Doc, "methodName", dispidmethodName, internalName, VT_EMPTY, VTS_NONE)
  END_DISPATCH_MAP()
  

• Gera a seguinte implementação de método associada:

  void CMFCApplication2Doc::internalName()
  {
       AFX_MANAGE_STATE(AfxGetAppModuleState());
       // TODO: Add your dispatch handler code here
  }
  

Adicionar um método a uma interface

1. No menu Visualizar , selecione Vista de Classes.

2. Na Vista de Classe, expanda o nó do projeto para mostrar a interface à qual pretende adicionar o método.

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

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

5. No assistente Add IDL MFC Method , forneça informações sobre o método.

6. Selecione OK para adicionar o método.

Lista de elementos da interface do usuário

A secção seguinte descreve a interface do assistente do método Add IDL MFC:

• Nome do método

  Defina o nome do método. A tabela seguinte descreve as opções de nomes do método dependendo do tipo de interface:

  Tipo de interface	Nome do método
  Interface dupla ATL, interface personalizada e interface personalizada local	Dê o seu próprio nome de método.
  Desinterface MFC	Dê o seu próprio nome de método ou selecione um nome sugerido da lista. Se selecionares um nome da lista, o tipo de devolução apropriado aparece em Tipo de devolução e não pode ser alterado.
  Desinterface de controlo MFC ActiveX	Dê o seu próprio nome de método ou selecione um dos métodos padrão: DoClick ou Refresh. Para mais informações sobre métodos de stock, veja controlos MFC ActiveX: Adicionar métodos de stock.

• Nome interno

  Disponível apenas quando o tipo de método for personalizado. Nome interno é o nome que será usado no mapa de despacho, no ficheiro de cabeçalho (.h) e no ficheiro de implementação (.cpp). Por defeito, este nome é o mesmo que o nome do Método. Isto foi adicionado à disinterface do MFC.

  Se estiver a adicionar o método a uma disinterface de controlo MFC ou MFC ActiveX, pode alterar o nome do método conforme descrito na tabela seguinte:

  Tipo de interface	Nome interno
  Interface dupla ATL, interface personalizada e interface personalizada local	Não disponível.
  Desinterface MFC	Definido para o nome do método por defeito. Podes editar o nome interno.
  Desinterface de controlo MFC ActiveX	Podes definir o nome interno apenas para métodos personalizados. Os métodos de stock não usam um nome interno.

• Tipo de retorno

  O tipo de dado devolvido pelo método. O tipo padrão de retorno para métodos de interface é HRESULT.

  Se a interface for dupla ou personalizada, apenas o HRESULT tipo de retorno é permitido.

  Pode definir o tipo de dado de acordo com o tipo de interface a que o método está a ser adicionado, conforme descrito na tabela seguinte:

  Tipo de interface	Tipo de retorno
  Interface dual	HRESULT. Imutável.
  Interface personalizada	HRESULT. Imutável.
  Interface local personalizada	Forneça o seu próprio tipo de declaração ou escolha um da lista.
  Disinterface	Forneça o seu próprio tipo de declaração ou escolha um da lista.
  Desinterface de controlo MFC ActiveX	Se implementar um método de stock, o tipo de retorno é definido para o valor apropriado e é inalterável. Se selecionares um método da lista de nomes do método e selecionares Personalizado em Selecionar tipo de método, seleciona um tipo de retorno da lista.

• Tipo de método

  Disponível apenas para controlos MFC ActiveX. Não disponível se forneceu um nome de método no nome do método em vez de selecionar um método da lista.

  Se selecionares um dos métodos na lista de nomes de Métodos , no menu suspenso de Tipo de Método seleciona a implementação Stock ou Personalizada . A seleção do método afeta o tipo de retorno e a implementação do método que o assistente fornece, conforme descrito na tabela seguinte:

  Tipo de método	Description
  Material	O padrão. Insere a implementação padrão do método selecionado na lista de nomes do Método . O tipo de devolução é inalterável se selecionares Stock.
  Personalizado	Fornece uma implementação personalizada para o método selecionado no nome do Método. Pode fornecer o seu próprio tipo de declaração ou escolher um da lista de tipos de declaração .

• Parâmetros

  Mostra os parâmetros, modificadores e tipos do método. O assistente atualiza a lista de Parâmetros à medida que adicionas parâmetros.

• +

  Adiciona um parâmetro. Em Parâmetros, escreva o tipo de parâmetro, o nome e quaisquer modificadores. Por exemplo, int x, e escolham OK.

  Se não fornecer um nome de parâmetro, o assistente ignora quaisquer seleções de tipo de Parâmetro ; e para projetos ATL, os atributos dos parâmetros também são ignorados.

• x

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

• Ícone de lápis

  Editar o parâmetro selecionado.

• id

  Define o ID numérico que identifica o método. Para mais informações, consulte id a referência do MIDL.

• call_as

  Especifica o nome do método remoto a mapear para este método local. Para mais informações, consulte call_as a referência do MIDL.

• helpcontext

  Especifica um ID de contexto que permite ao utilizador ver informações sobre este método no ficheiro de Ajuda. Para mais informações, consulte helpcontext a referência do MIDL.

• helpstring

  Especifica um texto que descreve o elemento associado. Por defeito, o seu nome Método. Para mais informações, consulte helpstring na referência MIDL.

Consulte também

Assistente de adicionar método
Adicionar um assistente de método IDL
Assistentes MFC e caixas de diálogo