Класс CSimpleDialog

Замечание

Библиотека активных шаблонов (ATL) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Этот класс реализует базовое модальное диалоговое окно.

Синтаксис

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.

Замечания

Этот метод обрабатывает все взаимодействие с пользователем во время активного диалогового окна. Это то, что делает диалоговое окно модальным; То есть пользователь не может взаимодействовать с другими окнами, пока диалоговое окно не будет закрыто.

См. также

Общие сведения о классе