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 de 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 (confira Como adicionar 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 de 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 de membro existirá somente enquanto a caixa de diálogo existir. Você não poderá consultar o controle de valores de entrada depois que a caixa de diálogo for 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 caixa de diálogo para definir ou recuperar valores dos controles em uma caixa de diálogo.

Comentários

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

O que você deseja 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)

Confira também

Criando e usando controles
Controles