Adicionar uma variável de membro

É possível adicionar uma variável de membro a uma classe usando o Modo de Exibição de Classe. As variáveis de membro podem se destinar à troca e à validação de dados ou podem ser genéricas. O assistente de variável de membro de dados foi projetado para encontrar as informações relevantes e usá-las para inserir elementos nos arquivos de origem nos locais apropriados. É possível adicionar uma variável de membro por meio do Editor de caixas de diálogo em Modo de Exibição de Recursos ou por meio de Modo de Exibição de Classe.

Para adicionar uma variável de membro a um controle de caixa de diálogo em Modo de Exibição de Recursos usando o Assistente de Adição de Variável de Membro:

1. Em Modo de Exibição de Recursos, expanda o nó do projeto e o nó Caixa de Diálogo para exibir a lista de caixas de diálogo do projeto.

2. Clique duas vezes na caixa de diálogo à qual deseja adicionar a variável de membro para abri-la no Editor de caixas de diálogo.

3. Na caixa de diálogo exibida no Editor de caixas de diálogo, clique com o botão direito do mouse no controle ao qual deseja adicionar a variável de membro.

4. No menu de atalho, escolha Adicionar Variável para exibir o Assistente de adição de variável de membro.

   Observação

   Um valor padrão já é fornecido em ID de Controle.

5. Forneça as informações nas caixas apropriadas do assistente. Para obter mais informações, confira controles de caixa de diálogo e tipos de variáveis.

6. Selecione Concluir para adicionar o código de definição e de implementação ao projeto e fechar o assistente.

Para adicionar uma variável de membro por meio do Modo de Exibição de Classe usando o Assistente de Adição de Variável de Membro:

1. Em Modo de Exibição de Classe, expanda o nó do projeto para exibir as classes no projeto.

2. Clique com o botão direito do mouse na classe à qual deseja adicionar uma variável.

3. No menu de atalho, escolha Adicionar e, em seguida, Adicionar Variável para exibir o Assistente de Adição de Variável de Membro.

4. Forneça as informações nas caixas apropriadas do assistente. Para obter mais informações, confira Assistente de adição de variável de membro.

5. Selecione Concluir para adicionar o código de definição e de implementação ao projeto e fechar o assistente.

Nesta seção

• Assistente de adição de variável de membro
• Controles da caixa de diálogo e tipos de variável

Assistente de adição de variável de membro

Este assistente adiciona uma declaração de variável de membro ao arquivo de cabeçalho. Dependendo das opções, pode adicionar código ao arquivo .cpp. Depois de adicionar a variável de membro usando o assistente, edite o código no ambiente de desenvolvimento.

• Acesso

  Define o acesso à variável de membro. Modificadores de acesso são palavras-chave que especificam o acesso que outras classes têm à variável de membro. Para obter mais informações sobre como especificar o acesso, confira controle de acesso a membro. O nível de acesso da variável de membro é definido como public por padrão.

  • público
  • protected
  • private

• Tipo de variável

  Define o tipo de retorno da variável de membro que está sendo adicionada.

  • Se estiver adicionando uma variável de membro que não é um controle de caixa de diálogo, selecione uma opção na lista de tipos disponíveis.

    Para obter informações sobre os tipos, confira tipos fundamentais.

    • char
    • double
    • float
    • int
    • long
    • short
    • unsigned char
    • unsigned int
    • unsigned long

  • Se estiver adicionando uma variável de membro a um controle de caixa de diálogo, essa caixa será preenchida com o tipo do objeto que é retornado para um controle ou um valor. Se você selecionar Controle, a opção Tipo de variável especificará a classe base do controle selecionado na caixa ID de Controle. Se o controle de caixa de diálogo puder guardar um valor e você selecionar Valor, a opção Tipo de variável especificará o tipo apropriado para o valor que o controle pode guardar. Para obter mais informações, confira controles de caixa de diálogo e tipos de variáveis.

    Esse valor depende da seleção em ID de Controle e não pode ser alterado.

• Nome da variável

  Define o nome da variável de membro que está sendo adicionada. Normalmente, as variáveis de membro começam com a cadeia de caracteres de identificação m_, que é fornecida para você por padrão.

• Variável de controle

  Indica que a variável de membro gerencia um controle em uma caixa de diálogo com o suporte da troca e validação de dados. Para obter mais informações, confira DoDataExchange. Essa opção está disponível somente para as variáveis de membro adicionadas às classes derivadas de CDialog. Marque essa caixa para ativar as opções ID de Controle e Tipo de controle.

• ID do controle

  Define a ID para a variável de controle que está sendo adicionada. Selecione na lista a ID do tipo de controle ao qual a variável de membro está sendo adicionada. A lista fica ativa somente quando a caixa Variável de controle está selecionada e é limitada às IDs dos controles que já foram adicionados à caixa de diálogo. Por exemplo, para o botão OK padrão, a ID de Controle é IDOK.

  Opção	Descrição
  Controle	Essa opção está definida por padrão para o tipo de controle. Ela gerencia o próprio controle e não o estado nem o conteúdo do controle (como talvez você deseje fazer com uma caixa de listagem, caixa de combinação ou caixa de edição).
  Valor	Essa opção está disponível para tipos de controle que podem conter um valor ou mostrar um estado, como uma caixa de edição ou uma caixa de seleção. Também está disponível para tipos de controle para os quais você pode gerenciar o intervalo, o conteúdo ou o estado. Para obter mais informações, confira controles de caixa de diálogo e tipos de variáveis.

• Categoria

  Especifica se a variável baseia-se em um tipo de controle ou no valor do controle.

• Tipo de controle

  Define o tipo de controle que está sendo adicionado. Essa caixa não está disponível para alteração. Por exemplo, um botão tem o tipo de controle BUTTON, e uma caixa de combinação tem o tipo de controle COMBOBOX. Para obter mais informações, confira controles de caixa de diálogo e tipos de variáveis.

• Número máx. de caracteres

  Disponível somente quando a opção Tipo de variável é definida como CString. Indica o número máximo de caracteres que o controle pode conter.

• Valor mínimo

  Disponível apenas quando o tipo de variável é BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency ou CTime. Indica o menor valor aceitável para uma escala ou um intervalo de datas.

• Valor máximo

  Disponível apenas quando o tipo de variável é BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency ou CTime. Indica o maior valor aceitável para uma escala ou um intervalo de datas.

• Arquivo .h

  Para controles ActiveX, cujas variáveis de membro exigem uma classe wrapper. Define o nome do arquivo de cabeçalho para adicionar a declaração de classe.

• Arquivo .cpp

  Para controles ActiveX, cujas variáveis de membro exigem uma classe wrapper. Define o nome do arquivo de implementação para adicionar a definição de classe.

• Comentário

  Fornece um comentário no arquivo de cabeçalho da variável de membro.

Controles da caixa de diálogo e tipos de variável

Use o assistente de adição de variável de membro para adicionar uma variável de membro a um controle de caixa de diálogo criado usando o MFC. O tipo de controle ao qual você adiciona a variável de membro determina as opções exibidas na caixa de diálogo.

A tabela a seguir descreve todos os tipos de controle de caixa de diálogo compatíveis com o MFC e o Editor de caixas de diálogo. Também exibe os tipos e valores disponíveis.