如何取消MFC CMFCShellTreeCtrl中所有复选框的选中状态？

1. 禁用用户手动操作复选框 #

要阻止用户点击复选框修改状态，可通过以下两种方式实现：

方法一：拦截NM_CLICK消息 #

void CYourDlg::OnNMClickMFCshelltree(NMHDR* pNMHDR, LRESULT* pResult)
{
    UINT uFlags;
    CPoint pt;
    GetCursorPos(&pt);
    myctree.ScreenToClient(&pt);
    HTREEITEM hItem = myctree.HitTest(pt, &uFlags);
    
    // 点击复选框区域时屏蔽操作
    if (hItem != NULL && (uFlags & TVHT_ONITEMSTATEICON))
    {
        *pResult = 1;
        return;
    }

    *pResult = 0;
}

方法二：处理TVN_ITEMCHANGING消息 #

void CYourDlg::OnTvnItemchangingMFCshelltree(NMHDR *pNMHDR, LRESULT *pResult)
{
    NMTREEVIEW* pNMTreeView = reinterpret_cast<NMTREEVIEW*>(pNMHDR);
    
    // 仅允许程序代码修改复选框状态
    if ((pNMTreeView->uChanged & TVIF_STATE) && 
        (pNMTreeView->itemNew.state ^ pNMTreeView->itemOld.state) & TVIS_STATEIMAGEMASK)
    {
        *pResult = TRUE; // 取消用户触发的复选框修改
        return;
    }

    *pResult = FALSE;
}

2. 保存当前勾选项指针，避免全量遍历 #

在对话框/窗口类的头文件中添加成员变量，记录上一个被勾选的树项：

private:
    HTREEITEM m_hLastCheckedItem;

在初始化函数（如OnInitDialog）中初始化该变量：

m_hLastCheckedItem = NULL;

3. 选中项变化时同步复选框状态 #

在On_TvnSelChangedMFCshelltree函数中，先取消上一个项的复选框，再勾选当前选中项：

void CYourDlg::On_TvnSelChangedMFCshelltree(NMHDR *pNMHDR, LRESULT *pResult)
{
    LPNMTREEVIEW pNMTreeView = reinterpret_cast<LPNMTREEVIEW>(pNMHDR);
    
    // 取消上一个选中项的复选框
    if (m_hLastCheckedItem != NULL)
    {
        myctree.SetCheck(m_hLastCheckedItem, FALSE);
    }

    // 获取并勾选当前选中项
    HTREEITEM hCurrentItem = pNMTreeView->itemNew.hItem;
    if (hCurrentItem != NULL)
    {
        myctree.SetCheck(hCurrentItem, TRUE);
        m_hLastCheckedItem = hCurrentItem;
    }

    *pResult = 0;
}

注意事项 #

• 确保初始化时已开启控件的复选框功能：myctree.SetCheckboxes(TRUE);
• 保存单个指针的方式避免了全量遍历所有节点的性能损耗，适合节点数量较多的场景

内容的提问来源于stack exchange，提问作者Doc DJ