Adicionar uma propriedade IDL MFC

O assistente Adicionar IDL MFC Property adiciona uma propriedade a uma interface IDL (Interface Definition Library) definida em seu projeto Microsoft Framework Class (MFC).

Para usar esse assistente, você deve estar em um projeto MFC, projeto ActiveX ou um projeto ATL que ofereça suporte a MFC. Por exemplo, se você tiver um projeto de controle Microsoft ActiveX, poderá usar o procedimento a seguir para adicionar uma propriedade a uma interface IDL na solução.

Adicionar uma propriedade IDL MFC à sua interface

1. No menu Ver, selecione Vista de Classes.

2. No painel Modo de Exibição de Classe , clique com o botão direito do mouse no nome da interface à qual você deseja adicionar a propriedade.

   Observação

   Você também pode adicionar propriedades a dispinterfaces, que, a menos que o projeto seja atribuído, ficam aninhados no nó da biblioteca.

3. No menu de atalho, escolha Adicionar>propriedade.

4. No assistente Adicionar propriedade IDL MFC , forneça as informações para criar a propriedade.

5. Selecione OK para adicionar a propriedade.

Para dispinterfaces MFC:

• Se você selecionar a variável Member como o tipo de implementação, um método e uma variável serão adicionados à classe que a implementa.
• Se você selecionar métodos Get/set como o tipo de implementação, dois métodos serão adicionados à classe que o implementa.

Lista de elementos da interface do usuário

A seção a seguir descreve o assistente Adicionar IDL MFC Property :

• Nome da propriedade

  Define o nome da propriedade.

  Para dispinterfaces MFC associadas a controles ActiveX, você pode fornecer seu próprio nome ou selecionar um nome de propriedade de estoque na lista predefinida. Se você fornecer seu próprio nome de propriedade, o tipo de implementação de estoque não estará disponível.

  Para obter mais informações sobre uma descrição das propriedades de estoque na lista, consulte propriedades de estoque.

  Tipo de interface	Opções de nome de propriedade
  Interface dupla ATL, interface personalizada e interface personalizada local	Forneça um nome de propriedade.
  MFC dispinterface, MFC ActiveX control dispinterface	Forneça um nome de propriedade ou selecione uma propriedade de estoque na lista. Se você selecionar uma propriedade na lista, o valor apropriado aparecerá na caixa Tipo de propriedade . Você pode alterar esse tipo, dependendo da seleção do tipo de implementação .

• Tipo de propriedade

  Define o tipo de propriedade que você está adicionando.

  Para dispinterfaces MFC, forneça seu próprio tipo ou selecione na lista predefinida. Se você fornecer uma implementação de estoque de uma propriedade, Tipo de propriedade é o tipo de estoque e não pode ser alterado.

• Nome da variável

  Define o nome da variável de membro à qual a propriedade está associada.

  Por padrão, o nome da variável é m_PropertyName. Você pode editar esse nome.

  Este campo só é visível para dispinterfaces MFC e se você especificar a variável Member em Tipo de implementação.

• Função de notificação

  Define o nome da função de notificação chamada se a propriedade for alterada.

  Por padrão, o nome da função de notificação é OnPropertyNameChanged. Você pode editar esse nome.

  Este campo só é visível para dispinterfaces MFC e se você especificar a variável Member em Tipo de implementação.

• Obter função

  Define o nome da função para obter a propriedade.

  Por padrão, o Get nome da função é GetPropertyName. Você pode editar esse nome.

  Se você excluir o nome, a função GetNotSupported será inserida no mapa de despacho da interface.

  Este campo só é visível para dispinterfaces MFC e se você especificar métodos Get/set em Tipo de implementação.

• Definir função

  Define o nome da função para definir a propriedade.

  Por padrão, o Set nome da função é SetPropertyName. Você pode editar esse nome.

  Se você excluir o nome, a função SetNotSupported será inserida no mapa de despacho da interface.

  Este campo só é visível para dispinterfaces MFC e se você especificar métodos Get/set em Tipo de implementação.

• Tipo de execução

  Especifica como implementar a propriedade que você está adicionando.

  Disponível apenas para dispinterfaces MFC.

  Tipo de execução	Descrição
  Stock	Especifica uma implementação padrão para a propriedade selecionada em Nome da propriedade. Para obter mais informações, consulte propriedades de estoque. Se você especificar Stock, o tipo de propriedade, o tipo de parâmetro e o nome do parâmetro ficarão esmaecidos.
  Variável de membro	Adiciona a propriedade como uma variável membro. Você pode adicionar propriedades personalizadas ou a maioria das propriedades de estoque como variáveis de membro. Fornece nomes padrão em Nome da variável e Função de notificação. Você pode editar esse nome. Não é possível especificar a variável Member para as Captionpropriedades , hWndou Text .
  Métodos Get/set	Especifica que a propriedade é adicionada como Getfunções PropertyName e SetPropertyName por padrão. Esses nomes aparecem em Obter função e Definir função. Você pode alterar o tipo de propriedade padrão, que passa um valor para a função Get. Você pode especificar parâmetros para as Get funções e Set .

• Propriedade padrão

  Define a propriedade como padrão para a interface.

  Uma interface pode ter apenas uma propriedade padrão.

  Depois de especificar a propriedade padrão, essa caixa de seleção não estará disponível para quaisquer outras propriedades adicionadas à interface. Disponível apenas para uma dispinterface MFC.

• Parâmetros

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

• +

  Adiciona um parâmetro. Em Parâmetros, digite o tipo e o nome do parâmetro e escolha OK. Por exemplo, int x

• x

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

• Ícone de lápis

  Edita o parâmetro selecionado.

• ID

  Define a ID numérica que identifica a propriedade.

  Esta opção não está disponível para propriedades de interfaces personalizadas. Para obter mais informações, consulte id a Referência MIDL.

• helpcontext

  Especifica uma ID de contexto que permite ao usuário exibir informações sobre essa propriedade no arquivo de Ajuda.

  Para obter mais informações, consulte helpcontext a Referência MIDL.

• helpstring

  Especifica uma cadeia de caracteres usada para descrever o elemento ao qual ela se aplica. Por padrão, é Nome da propertypropriedade.

  Para obter mais informações, consulte helpstring a Referência MIDL.

Propriedades em stock

Se você estiver adicionando uma propriedade a uma dispinterface MFC, poderá escolher uma das seguintes propriedades de estoque na lista suspensa Nome da propriedade :

Ver também

Adicionar propriedade

Adicionar propriedade IDL