Partilhar via


Adicionar uma variável de membro

Você pode adicionar uma variável de membro a uma classe usando o Modo de Exibição de Classe. As variáveis de membro podem ser para troca de dados e validação de dados, ou podem ser genéricas. O assistente de variáveis de membro de dados foi projetado para recolher as informações relevantes e usá-las para inserir elementos nos seus ficheiros de código-fonte nos locais apropriados. Você pode adicionar uma variável de membro a partir do editor de Diálogo na Vista de Recurso ou na Vista de Classe.

Observação

Ao projetar e implementar uma caixa de diálogo, você pode achar mais eficiente usar o editor de caixa 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 para um controle de caixa de diálogo no Modo de Exibição de Recursos usando o Assistente para Adicionar Variável de Membro:

  1. Na Vista de Recursos, expanda o nó do projeto e o nó das Caixas de Diálogo para exibir a lista das caixas de diálogo do projeto.

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

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

  4. No menu de atalho, escolha Adicionar variável para exibir o assistente Adicionar variável de membro.

    Observação

    Um valor padrão já é fornecido na ID de controle.

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

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

Para adicionar uma variável de membro a partir da Vista de Classe utilizando o Assistente para Adicionar Variável de Membro:

  1. No 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 rato na classe à qual pretende adicionar uma variável.

  3. No menu de atalho, escolha Adicionar e, em seguida, escolha Adicionar variável para exibir o Assistente para adicionar variável de membro.

  4. Forneça as informações nas caixas apropriadas do assistente. Para obter mais informações, consulte Assistente de Adição de Variável de Membro.

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

Nesta secção

Assistente para adicionar variável de membro

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

  • Acesso

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

  • Tipo de variável

    Define o tipo de retorno para a variável de membro que você está adicionando.

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

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

      • char
      • double
      • float
      • int
      • long
      • short
      • unsigned char
      • unsigned int
      • unsigned long
    • Se você estiver adicionando uma variável de membro para um controle de caixa de diálogo, essa caixa será preenchida com o tipo de objeto retornado para um controle ou valor. Se você selecionar Control, Variable type especifica a classe base do controle selecionado na caixa Control ID . Se o controle de caixa de diálogo puder conter um valor e se você selecionar Valor, o tipo de variável especificará o tipo apropriado para o valor que o controle pode conter. Para obter mais informações, consulte Controles de caixa de diálogo e tipos de variáveis.

      Esse valor depende da seleção na ID do controle e não pode ser alterado.

  • Nome da variável

    Define o nome da variável de membro que você está adicionando. As variáveis de membro normalmente começam com a cadeia de caracteres m_de identificação , que é fornecida para você por padrão.

  • Variável de controlo

    Indica que a variável membro gerencia um controle dentro de uma caixa de diálogo com suporte à troca e validação de dados . Para obter mais informações, consulte DoDataExchange. Esta opção está disponível apenas para variáveis de membro adicionadas a classes derivadas de CDialog. Selecione esta caixa para ativar as opções ID de controlo e Tipo de controlo .

  • ID de controlo

    Define a ID da variável de controle que você está adicionando. Selecione na lista o ID do tipo de controle para o qual você está adicionando a variável membro. A lista fica ativa somente quando a caixa Variável de controle é selecionada e é limitada a IDs para os controles já adicionados à caixa de diálogo. Por exemplo, para o botão OK padrão, o ID de controle é IDOK.

    Opção Descrição
    Controlo Esta opção é definida por padrão para o tipo de controle. Ele gerencia o controle em si, não o estado ou o conteúdo do controle (como você pode querer gerenciar para 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. Ele também está disponível para tipos de controle para os quais você pode gerenciar intervalo, conteúdo ou estado. Para obter mais informações, consulte Controles de caixa de diálogo e tipos de variáveis.
  • Categoria

    Especifica se a variável é baseada em um tipo de controle ou o valor do controle.

  • Tipo de controlo

    Define o tipo de controle que está sendo adicionado. Esta caixa não está disponível para ser alterada. 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, consulte Controles de caixa de diálogo e tipos de variáveis.

  • Máximo de personagens

    Disponível somente quando Tipo de variável está definido como CString. Indica o maior número 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 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 valor mais alto aceitável para uma escala ou 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 para a variável membro.

Controles de caixa de diálogo e tipos de variáveis

Você pode usar o assistente para adicionar variável de membro para adicionar uma variável de membro a um controle de caixa de diálogo criado usando MFC. O tipo de controle para o qual você adiciona a variável de membro determina as opções que aparecem na caixa de diálogo.

A tabela a seguir descreve todos os tipos de controle de caixa de diálogo suportados no MFC e no editor de diálogo. Ele também exibe seus tipos e valores disponíveis.

Controlo Tipo de controlo Tipo de variável de controlo Tipo de variável de valor Valores mínimos/máximos (apenas tipo de valor)
Controlo de animação SysAnimate32 CAnimateCtrl Nenhuma; apenas controle N/A
Botão BOTÃO CButton Nenhuma; apenas controle N/A
Caixa de verificação VERIFICAR CButton BOOL Valor mínimo/valor máximo
Caixa de combinação CAIXA DE COMBINAÇÃO CComboBox CString Máximo de personagens
Controle de seletor de data e hora SysDateTimePick32 CDateTimeCtrl CTime Valor mínimo/valor máximo
Caixa Editar EDITAR CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime, ou COleCurrency Valor mínimo/valor máximo; alguns suportam caracteres max
Controlo por teclas de atalho msctls_hotkey32 CHotKeyCtrl Nenhuma; apenas controle N/A
Caixa de listagem CAIXA DE LISTAGEM CListBox CString Máximo de personagens
Controlo de lista SysListView32 CListCtrl Nenhuma; apenas controle N/A
Controlo de Calendário de Meses SysMonthCal32 CMonthCalCtrl CTime Valor mínimo/valor máximo
Controlo do progresso msctls_progress32 CProgressCtrl Nenhuma; apenas controle N/A
Controle Rich Edit 2 RichEdit20A CRichEditCtrl CString Máximo de personagens
Controle de edição avançada RICHEDIT CRichEditCtrl CString Máximo de personagens
Barra de rolagem (vertical ou horizontal BARRA DE ROLAGEM CScrollBar int Valor mínimo/valor máximo
Controle deslizante msctls_trackbar32 CSliderCtrl int Valor mínimo/valor máximo
Controlo da rotação msctls_updown32 CSpinButtonCtrl Nenhuma; apenas controle N/A
Controlo de tabulação SysTabControl32 CTabCtrl Nenhuma; apenas controle N/A
Controlo de árvores SysTreeView32 CTreeCtrl Nenhuma; apenas controle N/A