無標題欄視窗拖曳移動的最簡實現：OnNcHitTest + PostMessage

痛點

移除標題欄（WS_CAPTION）後，視窗失去原生拖曳移動能力。傳統做法需在 WM_LBUTTONDOWN/WM_MOUSEMOVE/WM_LBUTTONUP 中手動計算座標、調用 MoveWindow 或 SetWindowPos，代碼繁瑣且易出錯。

核心洞見

Windows 判斷滑鼠點擊位置是否屬於「標題欄」是透過 WM_NCHITTEST 回傳值：若回傳 HTCAPTION，系統自動進入視窗移動模式。我們只需讓客戶區也回傳 HTCAPTION，即可「欺騙」系統認為使用者點擊了標題欄。

三步走實現（不足 10 行核心代碼）

1. 類向導無法添加 WM_NCHITTEST，需手動映射

// 在 BEGIN_MESSAGE_MAP 中添加
ON_WM_NCHITTEST()

// 頭文件聲明
afx_msg UINT OnNcHitTest(CPoint point);

2. 實現 OnNcHitTest：客戶區偽裝成標題欄

UINT CMyDialog::OnNcHitTest(CPoint point) {
    UINT nHitTest = CDialog::OnNcHitTest(point); // 先讓基類判斷
    // 若基類認為在客戶區 (HTCLIENT)，我們強制改為 HTCAPTION
    return (nHitTest == HTCLIENT) ? HTCAPTION : nHitTest;
}

3. 處理 WM_LBUTTONDOWN：轉發非客戶區左鍵下按消息

void CMyDialog::OnLButtonDown(UINT nFlags, CPoint point) {
    CDialog::OnLButtonDown(nFlags, point); // 保留基類行為
    // 關鍵：發送 WM_NCLBUTTONDOWN，wParam=HTCAPTION，系統即啟動拖曳
    PostMessage(WM_NCLBUTTONDOWN, HTCAPTION, MAKELPARAM(point.x, point.y));
}

原理圖解

滑標點擊客戶區
      │
      ▼
WM_NCHITTEST 返回 HTCAPTION (經過我們的攔截)
      │
      ▼
系統認為點擊了標題欄，準備進入移動模式
      │
      ▼
WM_LBUTTONDOWN 觸發
      │
      ▼
PostMessage(WM_NCLBUTTONDOWN, HTCAPTION, ...)
      │
      ▼
系統正式啟動視窗拖曳移動循環 (內部處理 WM_MOUSEMOVE/WM_LBUTTONUP)

優缺點對比

進階：保留客戶區左鍵響應

若視窗客戶區內有控件（按鈕、編輯框）需接收左鍵點擊，可在 OnNcHitTest 中進一步判斷：

UINT CMyDialog::OnNcHitTest(CPoint point) {
    UINT nHitTest = CDialog::OnNcHitTest(point);
    if (nHitTest == HTCLIENT) {
        // 檢查滑鼠下是否有子控件
        CWnd* pChild = ChildWindowFromPoint(point);
        if (pChild && pChild != this) return HTCLIENT; // 有控件則不攔截
        return HTCAPTION; // 空白區域才偽裝標題欄
    }
    return nHitTest;
}

適用場景總結

• 無邊框視窗、自定義標題欄、Kiosk 模式應用、全屏播放器、邊框極簡風格 UI。
• VC6.0 / VS2019 / VS2022 均驗證通過，MFC / WTL / 純 SDK 通用。

掌握 WM_NCHITTEST 這一「非客戶區測試」機制，是 Windows 視窗進階定制的基石之一。