Функция EndDialog (winuser.h)

Статья
08/27/2023

Уничтожает модальное диалоговое окно, в результате чего система завершает обработку этого диалогового окна.

Синтаксис

BOOL EndDialog(
  [in] HWND    hDlg,
  [in] INT_PTR nResult
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор для уничтожаемого диалогового окна.

[in] nResult

Тип: INT_PTR

Значение, возвращаемое приложению из функции, создающей диалоговое окно.

Возвращаемое значение

Тип: BOOL

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-dialogbox-l1-1-0 (представлено в Windows 8)