Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.
Esta 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
O ID do recurso do template de diálogo.
t_bCenter
TRUE se o objeto de diálogo for centrado na janela do proprietário; caso contrário, FALSO.
Membros
Métodos Públicos
| Nome | Description |
|---|---|
| CSimpleDialog::D oModal | Cria uma caixa de diálogo modal. |
Observações
Implementa uma caixa de diálogo modal com funcionalidade básica.
CSimpleDialog fornece suporte apenas para controlos comuns do Windows. Para criar e mostrar uma caixa de diálogo modal, crie uma instância desta classe, fornecendo o nome de um modelo de recurso existente para a caixa de diálogo. O objeto da caixa de diálogo fecha quando o utilizador clica em qualquer controlo com um valor pré-definido (como IDOK ou IDCANCEL).
CSimpleDialog permite criar apenas caixas de diálogo modais.
CSimpleDialog fornece o procedimento da caixa de diálogo, que utiliza o mapa de mensagens por defeito para direcionar mensagens para os handlers apropriados.
Consulte Implementar uma Caixa de Diálogo para mais informações.
Hierarquia de herança
CDialogImplBase
CSimpleDialog
Requerimentos
Cabeçalho: atlwin.h
CSimpleDialog::D oModal
Invoca uma caixa de diálogo modal e devolve o resultado da caixa de diálogo quando termina.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Parâmetros
hWndParent
Um handle para o pai da caixa de diálogo. Se não for fornecido nenhum valor, o pai é definido para a janela ativa atual.
Valor de retorno
Se for bem-sucedido, o valor de retorno é o ID do recurso do controlo que dispensou a caixa de diálogo.
Se a função falhar, o valor de retorno é -1. Para obter informações de erro estendidas, ligue para GetLastError.
Observações
Este método trata de toda a interação com o utilizador enquanto a caixa de diálogo está ativa. É isso 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.