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 |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
API 集 | windows 8 中引入的 ext-ms-win-ntuser-window-l1-1-0 () |
请参阅
概念性
引用