|
Страница 12 из 43
Функция 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Нет
Замечания по платформеНе имеется |