CWnd::DestroyWindow

销毁Windows窗口附加到 CWnd 对象。

virtual BOOL DestroyWindow( );

返回值

非零，则销毁窗口;否则为0。

备注

DestroyWindow 成员函数将相应信息到窗口停用并移除输入焦点。 如果 CWnd 是在浏览器链的顶部，它销毁windows的菜单中，对于应用程序队列，销毁处理计时器，还移除剪贴板所有权，以及中断剪贴板浏览器链。 其发送 WM_DESTROY 和 WM_NCDESTROY 信息到窗口。 但不销毁 CWnd 对象。

DestroyWindow 是进行清理一个位置容纳器。 由于 DestroyWindow 是虚函数，在所有 CWnd-在选件类视图的派生类公开。 但，即使您重写在您的 CWnd的此功能的派生类，DestroyWindow 不一定调用。 如果 DestroyWindow 在MFC代码未调用，则必须显式调用它在代码中，如果您希望此调用。

假定，例如，重写了 CView的 DestroyWindow 派生类。 因为MFC源代码不对 DestroyWindow 其任何 CFrameWnd派生类，重写的 DestroyWindow 不会调用，除非您显式调用它。

如果窗口是任何窗口的父级，自动销毁。这些子窗口，当销毁时父窗口。 DestroyWindow 成员函数首先然后销毁子窗口。

DestroyWindow 成员函数来销毁 CDialog::Create创建的无模式对话框。

如果销毁的 CWnd 是子窗口，并没有 WS_EX_NOPARENTNOTIFY 样式设置，则 WM_PARENTNOTIFY 发送到父级。

示例

// CModeless is a CDialog class representing a modeless dialog
// Destruction of the modeless dialog involves calling DestroyWindow in 
// OnOK() & OnCancel() handlers
void CModeless::OnOK() 
{ 
   if (!UpdateData(TRUE)) 
   {
      TRACE(_T("UpdateData failed during dialog termination\n"));
      // The UpdateData routine will set focus to correct item
      return;
   }
   DestroyWindow();
}

void CModeless::OnCancel()
{
   DestroyWindow();
}

要求

Header: afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd::OnDestroy

CWnd::Detach

DestroyWindow