Функция 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) |
Основные понятия
Справочные материалы