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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков.