MFC 模態與非模態對話框銷毀機制深度解析：正確姿勢避免記憶體洩漏與警告

前言

專案中使用非模態對話框，Debug 版本輸出警告：

Warning: calling DestroyWindow in CWnd::~CWnd OnDestroy or PostNcDestroy in derived class will not be called

表面是 Warning，實則隱含嚴重資源洩漏風險。本文系統梳理兩類對話框的銷毀流程、正確重寫姿勢、自動清理機制，並解答常見誤區。

一、 模態對話框：標準流程與等價關係

關閉呼叫鏈

// 使用者點擊 [確定] 按鈕 (IDOK)
OnOK() 
  → UpdateData(TRUE)      // 將控制項資料同步到成員變數
  → EndDialog(IDOK)
    → DestroyWindow()
      → OnDestroy()
      → PostNcDestroy()   // 此處預設不刪除 this（棧上物件）

// 使用者點擊 [取消] / 關閉按鈕 (IDCANCEL)
OnCancel() 
  → EndDialog(IDCANCEL)   // 無 UpdateData
    → DestroyWindow()
      → OnDestroy()
      → PostNcDestroy()

關鍵等價關係

• Close() ≡ OnCancel() ≡ EndDialog(IDCANCEL)
• OnOK() ≡ EndDialog(IDOK)（差別在於是否 UpdateData）

重寫原則

• 若重寫 OnOK()/OnCancel()/OnClose()，**必須呼叫基類版本**
• 模態對話框通常為棧上物件（DoModal() 內部建構），**無需手動 delete**

二、 非模態對話框：完全不同的規則

建立方式差異

正確關閉重寫模板

// MyModelessDlg.h
class CMyModelessDlg : public CDialog {
    DECLARE_DYNCREATE(CMyModelessDlg)
public:
    afx_msg void OnOK();     // 重寫
    afx_msg void OnCancel(); // 重寫
    virtual void PostNcDestroy(); // 關鍵：自動清理
};

// MyModelessDlg.cpp
void CMyModelessDlg::OnOK() {
    // 非模態：直接銷毀視窗，不要呼叫基類 OnOK()（會呼叫 EndDialog）
    DestroyWindow();
}

void CMyModelessDlg::OnCancel() {
    // 同理
    DestroyWindow();
}

void CMyModelessDlg::PostNcDestroy() {
    CDialog::PostNcDestroy(); // 基類清理
    delete this;              // 【核心】自動刪除堆上物件
}

三、 為什麼要在 PostNcDestroy 中 delete this？

1. DestroyWindow() 發送 WM_DESTROY → OnDestroy() → WM_NCDESTROY → PostNcDestroy()
2. PostNcDestroy() 是**視窗物件完全銷毀前的最後一個虛函式呼叫**
3. 此時視窗句柄已無效，但 C++ 物件仍存活，安全刪除
4. MFC 文檔明確建議：模態對話框不重寫，**非模態對話框必須重寫並 delete this**

四、 常見錯誤與誤區

五、 完整生命週期序列圖

非模態對話框：
new CMyDlg()          → 建構函式
  → Create()          → 建立視窗句柄
  → ShowWindow(SW_SHOW)
  → ... 使用者操作 ...
  → 點擊關閉/確定/取消
    → OnOK()/OnCancel() (重寫版)
      → DestroyWindow()
        → OnDestroy()
        → PostNcDestroy() (重寫版)
          → CDialog::PostNcDestroy()
          → delete this  ← 物件生命結束

六、 MSDN 官方文檔參考

CDialog::PostNcDestroy —— 英文原版說明，建議對照閱讀。

七、 總結檢查清單

• [ ] 模態對話框：重寫 OnOK/OnCancel/OnClose 時**必呼基類**
• [ ] 非模態對話框：OnOK/OnCancel 僅呼叫 DestroyWindow()
• [ ] 非模態對話框：**必須重寫 PostNcDestroy 並 delete this**
• [ ] 非模態對話框建立用 new，**不要**用棧上物件
• [ ] 檢查 Debug 輸出無 DestroyWindow in ~CWnd 警告

本文整理自原博客技術筆記，經結構化重寫發布