Usando controles comuns em uma caixa de diálogo

Os controles comuns do Windows podem ser usados em caixas de diálogo, exibições de formulário, exibições de registro e qualquer outra janela com base em um modelo de caixa de diálogo. O procedimento a seguir, com pequenas alterações, também funcionará para formulários.

Procedimentos

Para usar um controle comum em uma caixa de diálogo

1. Coloque o controle no modelo de caixa de diálogo usando o editor de diálogo.

2. Adicione à classe de diálogo uma variável de membro que representa o controle. Na caixa de diálogo Adicionar Variável de Membro , marque a variável Controle e verifique se o Controle está selecionado para a Categoria.

3. Se esse controle comum estiver fornecendo entrada para o programa, declare variáveis de membro adicionais na classe de diálogo para lidar com esses valores de entrada.

   Observação

   Você pode adicionar essas variáveis de membro usando o menu de contexto no Modo de Exibição de Classe (consulte Adicionando uma variável de membro).

4. No OnInitDialog para sua classe de diálogo, defina as condições iniciais para o controle comum. Usando a variável membro criada na etapa anterior, use as funções de membro para definir o valor inicial e outras configurações. Confira as descrições a seguir dos controles para obter detalhes sobre as configurações.

   Você também pode usar a DDX (troca de dados de caixa de diálogo) para inicializar controles em uma caixa de diálogo.

5. Em manipuladores para controles na caixa de diálogo, use a variável de membro para manipular o controle. Confira as descrições a seguir dos controles para obter detalhes sobre métodos.

   Observação

   A variável membro existirá somente desde que a caixa de diálogo em si exista. Você não poderá consultar o controle de valores de entrada depois que a caixa de diálogo tiver sido fechada. Para trabalhar com valores de entrada de um controle comum, substitua OnOK em sua classe de diálogo. Em sua substituição, consulte o controle para valores de entrada e armazene esses valores em variáveis de membro da classe de diálogo.

   Observação

   Você também pode usar a troca de dados de diálogo para definir ou recuperar valores dos controles em uma caixa de diálogo.

Observações

A adição de alguns controles comuns a uma caixa de diálogo fará com que a caixa de diálogo não funcione mais. Veja como adicionar controles a uma caixa de diálogo faz com que a caixa de diálogo não funcione mais para obter mais informações sobre como lidar com essa situação.

O que você quer fazer

• Adicionar controles a uma caixa de diálogo manualmente em vez de com o editor de diálogo

• Derivar meu controle de um dos controles comuns padrão do Windows

• Usar um controle comum como uma janela filho

• Receber mensagens de notificação de um controle

• Usar DDX (troca de dados de diálogo)

Consulte também

Fazendo e usando controles
Controles