Adicionar uma propriedade MFC do IDL

O assistente Adicionar Propriedade IDL do MFC adiciona uma propriedade a uma interface IDL definida em seu projeto de Classe do Microsoft Framework (MFC).

Para usar esse assistente, você precisa estar em um projeto MFC, projeto ActiveX ou um projeto ATL compatível com MFC. Por exemplo, se você tiver um projeto de controle do Microsoft ActiveX, poderá usar o procedimento a seguir para adicionar uma propriedade a uma interface IDL na solução.

Adicione uma propriedade MFC do IDL à interface

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

2. Em 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

   Adicione também propriedades a dispinterfaces, que estarão aninhadas no nó da biblioteca, a menos que o projeto esteja atribuído.

3. No menu de atalho, selecione Adicionar>Adicionar Propriedade.

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

5. Selecione OK para adicionar a propriedade.

Para dispinterfaces MFC:

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

Lista de elementos de interface do usuário

A seção a seguir descreve o Assistente Adicionar Propriedade MFC do IDL:

• Nome da propriedade

  Define o nome da propriedade.

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

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

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

• Tipo de propriedade

  Define o tipo de propriedade que está sendo adicionado.

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

• Nome da variável

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

  Por padrão, o nome da variável é m_PropertyName. É possível editar esse nome.

  Esse campo só fica visível para os despinterfaces MFC e se você especificar a variável Membro no tipo de implementação.

• Função de notificação

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

  Por padrão, o nome da função de notificação é OnPropertyNameChanged. É possível editar esse nome.

  Esse campo só fica visível para os despinterfaces MFC e se você especificar a variável Membro no tipo de implementação.

• Função Get

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

  Como padrão, o nome da função Get é GetPropertyName. É possível editar esse nome.

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

  Esse campo só fica visível para os despinterfaces MFC e se você especificar os métodos Get/Set no tipo de implementação.

• Função Set

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

  Como padrão, o nome da função Set é SetPropertyName. É possível editar esse nome.

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

  Esse campo só fica visível para os despinterfaces MFC e se você especificar os métodos Get/Set no tipo de implementação.

• Tipo de implementação

  Especifica como implementar a propriedade que está sendo adicionada.

  Disponível apenas para dispinterfaces MFC.

  Tipo de implementação	Descrição
  Stock	Especifica uma implementação padrão para a propriedade selecionada em Nome da propriedade. Para obter mais informações, confira Propriedades de estoque. Se você especificar Estoque, as opções Tipo de propriedade, Tipo de parâmetro e Nome do parâmetro ficarão esmaecidas.
  Variável de membro	Adiciona a propriedade como uma variável de membro. Adicione 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. É possível editar esse nome. Não é possível especificar Variável de membro para as propriedades Caption, hWnd ou Text.
  Métodos Get/Set	Especifica que a propriedade é adicionada como as funções GetPropertyName e SetPropertyName, por padrão. Esses nomes são exibidos em Função Get e Função Set. Altere o Tipo de propriedade padrão, que passa um valor para a função Get. Especifique parâmetros para as funções Get e Set.

• Propriedade padrão

  Define a propriedade como o 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 outras propriedades que você adicionar à interface. Disponível apenas 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 selecione 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.

  Essa opção não está disponível para propriedades de interfaces personalizadas. Para obter mais informações, confira id na Referência de 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, confira helpcontext na Referência de MIDL.

• helpstring

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

  Para obter mais informações, confira helpstring na Referência de MIDL.

Propriedades de estoque

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

Nome da propriedade	Descrição
Appearance	Retorna ou define um valor que determina a aparência do controle. A propriedade Appearance do controle pode incluir ou omitir efeitos de exibição tridimensionais. Essa propriedade é uma propriedade de leitura/gravação de ambiente.
BackColor	Retorna ou define a propriedade BackColor de ambiente do controle para uma cor da paleta (RGB) ou uma cor predefinida do sistema. Por padrão, seu valor corresponde à cor de primeiro plano do contêiner do controle. Essa propriedade é uma propriedade de leitura/gravação de ambiente.
BorderStyle	Retorna ou define o estilo da borda de um controle. Essa propriedade é uma propriedade de leitura/gravação.
Caption	Retorna ou define a propriedade Caption do controle. A legenda é o título da janela. Caption não tem nenhum tipo de implementação Variável de membro.
Enabled	Retorna ou define a propriedade Enabled do controle. Um controle habilitado pode responder aos eventos gerados pelo usuário.
Font	Retorna ou define a fonte de ambiente do controle. Null se o controle não tem nenhuma fonte.
ForeColor	Retorna ou define a propriedade ForeColor de ambiente do controle.
hWnd	Retorna ou define a propriedade hWnd do controle. Não tem nenhum tipo de implementação de variável de membro.
ReadyState	Retorna ou define a propriedade ReadyState do controle. Um controle pode estar nos seguintes estados: inicialização cancelada, inicializado, carregando, interativo ou completo. Para obter mais informações, confira READYSTATE no SDK da Internet.
Text	Retorna ou define o texto contido em um controle. Não tem nenhum tipo de implementação de variável de membro.

Confira também

Adicionar Propriedade

Adicionar a propriedade IDL