Win32 API. Справочник по диалоговому окну - Функция EndDialog

ОГЛАВЛЕНИЕ

Функция EndDialog

(ЗакончитьДиалог)

Функция EndDialog разрушает модальное диалоговое окно, вынуждая систему закончить любую обработку для блока диалога.

Синтаксис

BOOL EndDialog
(
HWND hDlg, // дескриптор диалогового окна
int nResult // возвращаемое значение
);

Параметры
hDlg
Идентифицирует диалоговое окно, которое будет разрушено.
nResult
Устанавливает значение, которое будет возвращено прикладной программе от функции, которая создавала диалоговое окно.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение отлично от нуля.
Если функция не выполняет задачу, возвращаемое значение нулевое.

Замечания
Диалоговые окна, созданные функциями DialogBox, DialogBoxParam, DialogBoxIndirect и DialogBoxIndirectParam должны быть разрушены, при помощи использования функции EndDialog. Прикладная программа вызывает EndDialog изнутри процедуры диалогового окна; функция не должна использоваться для какой-либо другой цели.
Процедура диалогового окна может вызывать EndDialog в любое время, даже в ходе обработки сообщения WM_INITDIALOG. Если ваша прикладная программа вызывает функцию, в то время, когда обрабатывается WM_INITDIALOG, диалоговое окно разрушается до того, как оно покажется и прежде установки в нем фокуса ввода.
EndDialog не разрушает немедленно диалоговое окно. Вместо этого, она устанавливает флажок и позволяет процедуре диалогового окна возвратить управление системе. Система проверяет наличие флажка перед попыткой извлечь следующее сообщение из очереди прикладной программы. Если флажок установлен, система заканчивает цикл сообщений, уничтожает диалоговое окно и использует значение в nResult как возвращаемое значение от функции, которая создавала блок диалога.

Смотри также
DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG

Размещение и совместимость EndDialog

Windows NT				Да 
Win95 Да
Win32s Да
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется