Поделиться через


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

Удаляет указанное окно. Функция отправляет WM_DESTROY и WM_NCDESTROY сообщения в окно, чтобы отключить его и удалить фокус клавиатуры. Функция также уничтожает меню окна, уничтожает таймеры, удаляет владение буфером обмена и разрывает цепочку просмотра буфера обмена (если окно находится в верхней части цепочки просмотра).

Если указанное окно является родительским окном или окном-владельцем, DestroyWindow автоматически уничтожает связанные дочерние или принадлежащие окна при уничтожении родительского окна или окна-владельца. Функция сначала уничтожает дочерние окна или собственные окна, а затем уничтожает родительское окно или окно владельца.

DestroyWindow также удаляет немодовые диалоговые окна, созданные функцией CreateDialog .

Синтаксис

BOOL DestroyWindow(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна, который необходимо уничтожить.

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

Тип: BOOL

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

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

Комментарии

Поток не может использовать DestroyWindow для уничтожения окна, созданного другим потоком.

Если уничтожаемое окно является дочерним окном без стиля WS_EX_NOPARENTNOTIFY , родительскому элементу отправляется WM_PARENTNOTIFY сообщение.

Примеры

Пример см. в разделе Уничтожение окна.

Требования

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

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

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

CreateDialog

CreateWindow

CreateWindowEx

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

WM_DESTROY

WM_NCDESTROY

WM_PARENTNOTIFY

Windows