Функция EndDialog

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

hDlg

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

Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Диалоговые окна, созданные функциями DialogBox, DialogBoxParam, DialogBoxIndirect и DialogBoxIndirectParam должны быть разрушены при помощи использования функции EndDialog. Приложение вызывает EndDialog из процедуры диалогового окна; функция не должна использоваться для какой-либо другой цели.

Процедура диалогового окна может вызывать EndDialog в любое время, даже в ходе обработки сообщения WM_INITDIALOG. Если ваша прикладная программа вызывает функцию в то время, когда обрабатывается WM_INITDIALOG, диалоговое окно разрушается до того, как оно показывается и до того, как в нем будет установлен фокус ввода.

Функция EndDialog немедленно не уничтожает диалоговое окно. Вместо этого, она устанавливает флажок и дает возможность процедуре диалогового окна возвратить управление системе. Система проверяет флажок перед попыткой восстановить следующее сообщение из очереди прикладных программ. Если флажок установлен, система заканчивает цикл сообщений, уничтожает диалоговое окно и использует значение в nResult как возвращаемое значение из функции, которая создала диалоговое окно.

Обзор Диалоговые окна, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG