DestroyWindow 函数 (winuser.h)

销毁指定的窗口。 该函数将 WM_DESTROYWM_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 (

另请参阅

概念性

CreateDialog

CreateWindow

CreateWindowEx

参考

WM_DESTROY

WM_NCDESTROY

WM_PARENTNOTIFY

Windows