Clase CSimpleDialog
Esta clase implementa un cuadro de diálogo modal básico.
Sintaxis
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Parámetros
t_wDlgTemplateID
[in] Id. de recurso de plantilla del recurso cuadro de diálogo.
t_bCenter
TRUE si el objeto de diálogo se va a centrar en la ventana del propietario; en caso contrario, FALSE.
Miembros
Métodos públicos
| Nombre | Descripción |
|---|---|
| CSimpleDialog::DoModal | Crea un cuadro de diálogo modal. |
Comentarios
Implementa un cuadro de diálogo modal con funcionalidad básica. CSimpleDialog solo proporciona compatibilidad para controles comunes de Windows Para crear y mostrar un cuadro de diálogo modal, cree una instancia de esta clase, proporcionando el nombre de una plantilla de recursos existente para el cuadro de diálogo. El objeto de cuadro de diálogo se cierra cuando el usuario hace clic en cualquier control con un valor predefinido (como IDOK o IDCANCEL).
CSimpleDialog solo permite crear cuadros de diálogo modales. CSimpleDialog proporciona el procedimiento del cuadro de diálogo, que usa la asignación de mensajes predeterminado para dirigir los mensajes a los controladores adecuados.
Consulte Implementar un cuadro de diálogo para más información.
Jerarquía de herencia
CDialogImplBase
CSimpleDialog
Requisitos
Encabezado: atlwin.h
CSimpleDialog::DoModal
Invoca un cuadro de diálogo modal y devuelve el resultado del cuadro de diálogo cuando haya terminado.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Parámetros
hWndParent
Manipulador del elemento primario del cuadro de diálogo. Si no se proporciona ningún valor, el elemento primario se establece en la ventana activa actual.
Valor devuelto
Si se ejecuta correctamente, el valor devuelto es el id. de recurso del control que descartó el cuadro de diálogo.
Si se produce un error en la función, el valor devuelto es -1. Para obtener información de errores extendida, realice una llamada a GetLastError.
Comentarios
Este método controla toda la interacción con el usuario mientras el cuadro de diálogo está activo. Esto es lo que hace que el cuadro de diálogo sea modal; es decir, el usuario no puede interactuar con otras ventanas hasta que se cierre el cuadro de diálogo.