Функция
DestroyWindowФункция
DestroyWindow разрушает заданное окно. Функция отправляет сообщения WM_DESTROY и WM_NCDESTROY окну, чтобы деактивировать его и удалить фокус клавиатуры из него. Функция также уничтожает меню окна, очищает очередь потоков сообщений, уничтожает таймеры, удаляет монопольное использование буфера обмена и разрывает цепочку просмотра окон буфера обмена (если окно имеет наверху цепочку просмотров).Если заданное окно - родитель или владелец окон,
DestroyWindow автоматически уничтожает связанные дочерние или находящиеся в собственности окна, когда она уничтожает окно владельца или родителя. Функция сначала уничтожает дочерние или находящиеся в собственности окна, а затем она уничтожает окно владельца или родителя.Функция
DestroyWindow уничтожает также и немодальные диалоговые окна, созданные функцией CreateDialog.Синтаксис
hWnd // дескриптор для разрушения окна ); |
Параметры
hWnd
[in] Дескриптор окна, которое будет разрушено.
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение нулевое. Чтобы получать расширенные данные об ошибках, вызовите функцию
GetLastError.Замечания
Поток не может использовать функцию
DestroyWindow, чтобы уничтожить окно, созданное другим потоком.Если разрушаемое окно - дочернее окно, которое не имеет стиля
WS_EX_NOPARENTNOTIFY, родителю отправляется сообщение WM_PARENTNOTIFY.Пример
Пример смотрите в статье
Разрушение окна.Смотри также
Краткий обзор Окна, CreateDialog, CreateWindow, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY
Размещение и совместимость DestroyWindow |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |