Classe CDialog

Artigo
06/10/2015

A classe base usada para exibir caixas de diálogo na tela.

class CDialog : public CWnd

Membros

Construtores public

Nome	Descrição
CDialog::CDialog	Constrói um objeto de CDialog .

Métodos públicos

Nome	Descrição
CDialog::Create	Inicializa o objeto de CDialog . Cria uma caixa de diálogo sem-modo e anexá-la ao objeto de CDialog .
CDialog::CreateIndirect	Cria uma caixa de diálogo sem-modo de um modelo da caixa de diálogo na memória (não com base nos recursos).
CDialog::DoModal	Chama uma caixa de diálogo modal e retorna quando acaba.
CDialog::EndDialog	Fechando uma caixa de diálogo modal.
CDialog::GetDefID	Obtém a identificação do controle de teclas padrão para uma caixa de diálogo.
CDialog::GotoDlgCtrl	Move o foco em um controle específico da caixa de diálogo na caixa de diálogo.
CDialog::InitModalIndirect	Cria uma caixa de diálogo modal de um modelo da caixa de diálogo na memória (não com base nos recursos). Os parâmetros são armazenadas até que a função está DoModal chamada.
CDialog::MapDialogRect	Converte as unidades de diálogo de um retângulo para selecionar unidades.
CDialog::NextDlgCtrl	Mova o foco para o próximo controle da caixa de diálogo na caixa de diálogo.
CDialog::OnInitDialog	Substituição para aumentar a inicialização da caixa de diálogo.
CDialog::OnSetFont	Substituição para especificar a fonte que um controle caixa de diálogo é usar quando desenha texto.
CDialog::PrevDlgCtrl	Mova o foco para o controle anterior da caixa de diálogo na caixa de diálogo.
CDialog::SetDefID	Altera o controle de teclas padrão para uma caixa de diálogo para uma tecla especificada.
CDialog::SetHelpID	Define um ID da ajuda contextual para a caixa de diálogo.

Métodos protegidos

Nome	Descrição
CDialog::OnCancel	Substitua para executar o botão cancelar a ação ou da tecla ESC. A opção fechar a caixa de diálogo e retorna IDCANCELde DoModal .
CDialog::OnOK	Substituição para executar a ação do botão OK em uma caixa de diálogo modal. A opção fechar a caixa de diálogo e retorna IDOKde DoModal .

Comentários

Caixas de diálogo são de dois tipos: modal e sem-modo. Uma caixa de diálogo modal deve ser fechada pelo usuário antes que o aplicativo continue. Uma caixa de diálogo sem-modo permite ao usuário exibir a caixa de diálogo e retorna a outra tarefa sem cancelar ou remova a caixa de diálogo.

Um objeto de CDialog é uma combinação de um modelo da caixa de diálogo e um CDialog- classe derivada. Use o editor de diálogo para criar o modelo da caixa de diálogo e armazená-lo em um recurso, então use o assistente para adicionar classe para criar uma classe derivada de CDialog.

Uma caixa de diálogo, como qualquer outra janela, recebe mensagens do windows. Em uma caixa de diálogo, particularmente você está interessado em notificações de manipulação dos controles da caixa de diálogo desde que é como o usuário interage com a caixa de diálogo. Usar a janela de propriedades para selecionar as mensagens que você deseja manipular e adicionar as entradas de mapa mensagem- e funções de membro apropriadas de mensagem- manipulador a classe para você. Você só precisa escrever código específico do aplicativo nas funções de membro do manipulador.

Se você preferir, você sempre pode escrever entradas e funções de membro de mapa mensagem- manualmente.

Em casos mas na caixa de diálogo para mais trivial, você adiciona variáveis de membro a sua classe derivada da caixa de diálogo para armazenar dados inseridos para controles da caixa de diálogo pelo usuário ou para exibir dados para o usuário. Você pode usar o assistente para adicionar variável criar variáveis de membro e para associá-los com os controles. A o mesmo tempo, você escolher um tipo de variável e um intervalo de valores permitido para cada variável. O assistente de código a seguir adiciona as variáveis de membro a sua classe derivada da caixa de diálogo.

Um mapa de dados é gerado para tratar automaticamente a troca de dados entre as variáveis de membro e os controles da caixa de diálogo. O mapa de dados fornece as funções que inicializam controles na caixa de diálogo com os valores apropriados, recuperar os dados, e validar os dados.

Para criar uma caixa de diálogo modal, construir um objeto na pilha usando o construtor para a classe derivado da caixa de diálogo e então chame DoModal para criar a janela da caixa de diálogo e seus controles. Se você desejar criar uma caixa de diálogo sem-modo, chame Criar no construtor de classe da caixa de diálogo.

Você também pode criar um modelo na memória usando uma estrutura de dados de DLGTEMPLATE como descrito em Windows SDK. Depois que você constrói um objeto de CDialog , chame CreateIndirect para criar uma caixa de diálogo sem-modo, ou a chamada InitModalIndirect e DoModal para criar uma caixa de diálogo modal.

O mapa de dados de troca e de validação é escrito em uma substituição de CWnd::DoDataExchange que é adicionada à sua nova classe da caixa de diálogo. Consulte a função de membro de DoDataExchange em CWnd para mais na funcionalidade de troca e validação.

O programador e a estrutura chamam DoDataExchange indiretamente com uma chamada a CWnd::UpdateData.

A estrutura chama UpdateData quando o usuário clica no botão OK para fechar a caixa de diálogo modal. (Os dados não são recuperados se o botão cancelar for clicado.) A implementação padrão de OnInitDialog também chama UpdateData para definir os valores iniciais dos controles. Você normalmente substitui OnInitDialog para inicializar mais controles. OnInitDialog é chamado os controles de caixa de diálogo é criado e quando imediatamente antes da caixa de diálogo é exibida.

Você pode chamar CWnd::UpdateData a qualquer momento durante a execução de uma caixa de diálogo modal ou sem janela restrita.

Se você desenvolver uma caixa de diálogo manualmente, você adiciona as variáveis de membros necessários para a classe derivado da caixa de diálogo você mesmo, e você adicionar funções de membro para obter ou definir esses valores.

Uma caixa de diálogo modal é fechado automaticamente quando o usuário pressionar os botões OK ou cancelar ou quando seu código chama a função de membro de EndDialog .

Quando você implementa uma caixa de diálogo sem-modo, sempre substituir a função de membro de OnCancel e chamar DestroyWindow de dentro de ele. Não chamar a classe base CDialog::OnCancel, porque chama EndDialog, que irão a caixa de diálogo invisível mas não o destruirá. Você também deve substituir PostNcDestroy para caixas de diálogo sem-modo para excluir this, desde que as caixas de diálogo sem-modo são atribuídas geralmente com new. Caixas de diálogo modais geralmente são construídas no quadro e não precisam a limpeza de PostNcDestroy .

Para obter mais informações sobre, consulte: CDialog