Adicionar uma variável de membro

  • Artigo

É 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.

Observação

Quando está projetando e implementando uma caixa de diálogo, talvez seja mais eficiente usar o Editor de caixas de diálogo para adicionar os controles de caixa de diálogo e, em seguida, implementar as variáveis de membro dos controles.

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

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.

  • 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.

Control Tipo de controle Tipo de variável de controle Tipo de variável de valor Valores mín./máx. (somente tipo de valor)
Controle de animação SysAnimate32 CAnimateCtrl Nenhum; somente controle N/D
Botão BUTTON CButton Nenhum; somente controle N/D
Caixa de seleção CHECK CButton BOOL Valor mín./valor máx.
Caixa de combinação COMBOBOX CComboBox CString Número máx. de caracteres
Controle de seletor de data e hora SysDateTimePick32 CDateTimeCtrl CTime Valor mín./valor máx.
Caixa de edição EDIT CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime ou COleCurrency Valor mín./valor máx.; alguns dão suporte ao número máximo de caracteres
Controle de tecla de acesso msctls_hotkey32 CHotKeyCtrl Nenhum; somente controle N/D
Caixa de listagem LISTBOX CListBox CString Número máx. de caracteres
Controle de lista SysListView32 CListCtrl Nenhum; somente controle N/D
Controle de calendário mensal SysMonthCal32 CMonthCalCtrl CTime Valor mín./valor máx.
Controle de progresso msctls_progress32 CProgressCtrl Nenhum; somente controle N/D
Controle de Rich Edit 2 RichEdit20A CRichEditCtrl CString Número máx. de caracteres
Controle de Rich Edit RICHEDIT CRichEditCtrl CString Número máx. de caracteres
Barra de rolagem (vertical ou horizontal) SCROLLBAR CScrollBar int Valor mín./valor máx.
Controle deslizante msctls_trackbar32 CSliderCtrl int Valor mín./valor máx.
Controle de giro msctls_updown32 CSpinButtonCtrl Nenhum; somente controle N/D
Controle guia SysTabControl32 CTabCtrl Nenhum; somente controle N/D
Controle de árvore SysTreeView32 CTreeCtrl Nenhum; somente controle N/D