Класс CSimpleDialog
Этот класс реализует базовое модальное диалоговое окно.
Синтаксис
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Параметры
t_wDlgTemplateID
Идентификатор ресурса шаблона диалогового окна.
t_bCenter
ЗНАЧЕНИЕ TRUE, если объект диалогового окна должен быть центрирован в окне владельца; в противном случае ЗНАЧЕНИЕ FALSE.
Участники
Открытые методы
| Имя | Описание |
|---|---|
| CSimpleDialog::D oModal | Создает модальное диалоговое окно. |
Замечания
Реализует модальное диалоговое окно с основными функциями. CSimpleDialog обеспечивает поддержку только общих элементов управления Windows. Чтобы создать и отобразить модальное диалоговое окно, создайте экземпляр этого класса, указав имя существующего шаблона ресурса для диалогового окна. Объект диалогового окна закрывается, когда пользователь щелкает любой элемент управления с предварительно определенным значением (например, IDOK или IDCANCEL).
CSimpleDialog позволяет создавать только модальные диалоговые окна. CSimpleDialog предоставляет процедуру диалогового окна, которая использует карту сообщений по умолчанию для направления сообщений в соответствующие обработчики.
Дополнительные сведения см . в разделе "Реализация диалогового окна ".
Иерархия наследования
CDialogImplBase
CSimpleDialog
Требования
Заголовок: atlwin.h
CSimpleDialog::D oModal
Вызывает модальное диалоговое окно и возвращает результат диалогового окна после завершения.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Параметры
hWndParent
Дескриптор родительского окна. Если значение не задано, родительский объект имеет текущее активное окно.
Возвращаемое значение
В случае успешного выполнения возвращаемое значение — это идентификатор ресурса элемента управления, который отклонил диалоговое окно.
Если функция завершается ошибкой, возвращаемое значение равно -1. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Этот метод обрабатывает все взаимодействие с пользователем во время активного диалогового окна. Это то, что делает диалоговое окно модальным; То есть пользователь не может взаимодействовать с другими окнами, пока диалоговое окно не будет закрыто.