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