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