Classe CSimpleDialog
Essa classe implementa uma caixa de diálogo modal básica.
Sintaxe
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Parâmetros
t_wDlgTemplateID
A ID do recurso do modelo de diálogo.
t_bCenter
TRUE se o objeto de diálogo deve ser centralizado na janela de proprietário; caso contrário, FALSE.
Membros
Métodos públicos
| Nome | Descrição |
|---|---|
| CSimpleDialog::DoModal | Cria uma caixa de diálogo modal. |
Comentários
Implementa uma caixa de diálogo modal com funcionalidade básica. CSimpleDialog dá suporte apenas para controles comuns do Windows. Para criar e exibir uma caixa de diálogo modal, crie uma instância dessa classe, fornecendo o nome de um modelo de recurso existente para a caixa de diálogo. O objeto da caixa de diálogo é fechado quando o usuário clica em qualquer controle com um valor predefinido (como IDOK ou IDCANCEL).
CSimpleDialog permite que você crie apenas caixas de diálogo modais. CSimpleDialog fornece o procedimento da caixa de diálogo, que usa o mapa de mensagens padrão para direcionar mensagens para os manipuladores apropriados.
Confira Como implementar uma caixa de diálogo para obter mais informações.
Hierarquia de herança
CDialogImplBase
CSimpleDialog
Requisitos
Cabeçalho: atlwin.h
CSimpleDialog::DoModal
Invoca uma caixa de diálogo modal e retorna o resultado da caixa de diálogo quando concluído.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Parâmetros
hWndParent
Um identificador para a caixa de diálogo pai. Se nenhum valor for fornecido, o pai será definido como a janela ativa atual.
Valor de retorno
Se tiver êxito, o valor retornado será a ID do recurso do controle que ignorou a caixa de diálogo.
Se a função falhar, o valor retornado será -1. Para obter outras informações sobre o erro, chame GetLastError.
Comentários
Esse método lida com toda a interação com o usuário enquanto a caixa de diálogo está ativa. Isso é o que torna a caixa de diálogo modal; ou seja, o usuário não pode interagir com outras janelas até que a caixa de diálogo seja fechada.