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 Devolução

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.

Confira também

Visão geral da classe