萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

MFC CTreeView Checkbox 完整使用指南

消息事件分析

CTreeView 中的 Checkbox 交互會觸發多種通知消息,理解其觸發條件至關重要:

操作觸發消息HitTest 標誌
點擊當前項目 CheckboxNM_CLICKTVHT_ONITEMSTATEICON
點擊當前項目文字NM_CLICK無特殊標誌
點擊新項目 CheckboxTVN_SELCHANGED + NM_CLICKTVHT_ONITEMSTATEICON
點擊新項目文字NM_CLICK + TVN_SELCHANGED無特殊標誌

處理策略

只需處理 NM_CLICK 即可覆蓋所有點擊場景,通過 HitTest 判斷是否點中 Checkbox。

關鍵注意事項

  1. 狀態自動翻轉:點擊 Checkbox 後,狀態已自動更新,勿調用 SetCheck,否則會導致狀態異常;GetCheck 返回的是翻轉前的原始狀態。
  2. 選中項不同步:點擊新項目的 Checkbox 時,該項目不會自動成為選中項,需手動調用 SelectItem。

遞歸處理邏輯

點擊 Checkbox 時(含 TVHT_ONITEMSTATEICON)

  1. 獲取當前項狀態並取反
  2. 若有子項,遞歸設置所有子項為相同狀態
  3. 若無子項:
    • 狀態為 TRUE → 設置父項為 TRUE
    • 狀態為 FALSE → 遍歷所有兄弟項,若全為 FALSE 則設置父項為 FALSE
  4. 將當前項設置為選中項

點擊文字時(無 TVHT_ONITEMSTATEICON)

  1. 更新選中項狀態
  2. 子項、父項邏輯同上

核心代碼實現

NM_CLICK 處理函數

void CTestTimerDlg::OnClickTree(NMHDR* pNMHDR, LRESULT* pResult)
{
    CPoint pt;
    GetCursorPos(&pt);
    m_TreeCtrl.ScreenToClient(&pt);

    UINT uFlags;
    HTREEITEM hItem = m_TreeCtrl.HitTest(pt, &uFlags);
    if (!hItem || (uFlags & TVHT_NOWHERE)) return;

    if (uFlags & TVHT_ONITEMSTATEICON) // 點中 Checkbox
    {
        m_TreeCtrl.SelectItem(hItem);
        BOOL bCheck = m_TreeCtrl.GetCheck(hItem); // 獲取翻轉前狀態
        SetChildCheck(hItem, !bCheck);            // 設置子項為新狀態
        SetParentCheck(hItem, bCheck);            // 根據原狀態更新父項
    }
    *pResult = 0;
}

遞歸設置子項

void CTestTimerDlg::SetChildCheck(HTREEITEM hItem, BOOL bCheck)
{
    m_TreeCtrl.Expand(hItem, TVE_EXPAND);
    HTREEITEM hChild = m_TreeCtrl.GetChildItem(hItem);
    while (hChild)
    {
        m_TreeCtrl.SetCheck(hChild, bCheck);
        SetChildCheck(hChild, bCheck); // 遞歸
        hChild = m_TreeCtrl.GetNextSiblingItem(hChild);
    }
}

遞歸更新父項

void CTestTimerDlg::SetParentCheck(HTREEITEM hItem, BOOL bOldCheck)
{
    HTREEITEM hParent = m_TreeCtrl.GetParentItem(hItem);
    if (!hParent) return;

    HTREEITEM hSibling = m_TreeCtrl.GetChildItem(hParent);
    BOOL bAllUnchecked = TRUE;
    while (hSibling)
    {
        if (hSibling == hItem) { hSibling = m_TreeCtrl.GetNextSiblingItem(hSibling); continue; }
        if (m_TreeCtrl.GetCheck(hSibling)) { bAllUnchecked = FALSE; break; }
        hSibling = m_TreeCtrl.GetNextSiblingItem(hSibling);
    }

    m_TreeCtrl.SetCheck(hParent, bAllUnchecked ? FALSE : TRUE);
    SetParentCheck(hParent, bOldCheck); // 繼續向上遞歸
}

總結

掌握 NM_CLICK + HitTest 模式,配合遞歸處理父子項狀態同步,即可實現符合直覺的樹形 Checkbox 聯動效果。關鍵在於區分「原始狀態」與「新狀態」,避免重複設置導致邏輯錯亂。

copyright © 萬盛學電腦網 all rights reserved