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

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

Синтаксис

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)

См. также раздел

Основные понятия

Диалоговые окна

Диалоговое окно

DialogBoxIndirect

DialogBoxIndirectParam

DialogBoxParam

Справочные материалы

WM_INITDIALOG