Hi，大家好！在Access應用程序開發中，TreeView控件（Microsoft TreeView Control）是構建層級數據展示（如組織架構、文件目錄）的常用工具。然而，其默認交互功能有限，缺少上下文相關的右鍵菜單（Context Menu）是其主要短板。本文將詳細介紹如何使用VBA，不依賴任何第三方控件，為TreeView實現一個功能完整的自定義右鍵菜單。
核心技術原理
實現此功能主要依賴於Access VBA環境下的三個核心對象與方法：TreeView.MouseDown 事件: 這是捕獲用户鼠標操作的入口。通過其 Button 參數，我們可以判斷用户按下的是否為鼠標右鍵（Button = 2）。TreeView.HitTest 方法: 此方法是關鍵。它接收鼠標的X、Y座標作為參數，並返回座標位置下的節點（Node）對象。這使得我們能夠精確地確定用户右擊的是哪個節點。Application.CommandBars 對象: Access（及整個Office套件）的菜單和工具欄系統都由 CommandBars 對象集合管理。我們可以通過它動態地創建、修改和顯示一個彈出式菜單（msoBarPopup）。整合這三點，我們的實現思路是：在MouseDown事件中捕獲右鍵點擊，通過HitTest定位目標節點，然後創建一個CommandBar彈出菜單並顯示在鼠標位置。
實現步驟
步驟一：定義菜單結構與回調函數（標準模塊）
菜單的定義及其點擊後執行的動作需要放在一個標準模塊中，以便窗體中的 OnAction 屬性可以正確調用。在VBA編輯器中，插入一個新的標準模塊，例如 modTreeViewHandler。將以下代碼複製到模塊中。

Option Compare Database
Option Explicit
 
' 定義常量以提高代碼可讀性和可維護性
Private Const POPUP_MENU_NAME As String = "tvwCustomPopup"

'================================================================================
' 函數: CreateOrUpdateContextMenu
' 作用: 創建或更新TreeView的右鍵菜單。在窗體加載時調用。
'================================================================================
Public Sub CreateOrUpdateContextMenu()
    Dim cb As Office.CommandBar
    Dim ctl As Office.CommandBarButton
    
    ' 為避免重複創建，先嚐試刪除已存在的同名菜單
    On Error Resume Next
    Application.CommandBars(POPUP_MENU_NAME).Delete
    On Error GoTo 0
    
    ' 創建一個新的彈出式菜單 (msoBarPopup = 5)
    Set cb = Application.CommandBars.Add(POPUP_MENU_NAME, msoBarPopup, False, True)
    
    ' --- 添加菜單項 ---
    
    ' 菜單項: 新增子節點
    Set ctl = cb.Controls.Add(msoControlButton)
    With ctl
        .Caption = "新增子節點(&A)"
        .OnAction = "=HandleAddChildNode()" ' 綁定到本模塊的公共函數
        .FaceId = 21 ' Office內置圖標ID
    End With
    
    ' 菜單項: 重命名
    Set ctl = cb.Controls.Add(msoControlButton)
    With ctl
        .Caption = "重命名(&R)"
        .OnAction = "=HandleRenameNode()"
        .FaceId = 355
    End With
    
    ' 菜單項: 刪除 (添加分隔線)
    Set ctl = cb.Controls.Add(msoControlButton)
    With ctl
        .BeginGroup = True ' 在此項前添加分隔線
        .Caption = "刪除(&D)"
        .OnAction = "=HandleDeleteNode()"
        .FaceId = 2950
    End With
End Sub

'================================================================================
' 以下是菜單項的回調函數，必須是Public Function
'================================================================================

Public Function HandleAddChildNode() As Boolean
    On Error GoTo Handle_Error
    Dim tvw As TreeView
    Dim selectedNode As Node
    
    Set tvw = Screen.ActiveForm.ActiveControl
    If TypeName(tvw) <> "TreeView" Then Exit Function
    
    Set selectedNode = tvw.SelectedItem
    If selectedNode Is Nothing Then Exit Function
    
    ' 添加一個新節點，Key必須唯一
    tvw.Nodes.Add relative:=selectedNode, relationship:=tvwChild, _
                  key:="nodeKey" & Timer, text:="新節點"
    
Handle_Exit:
    Exit Function
Handle_Error:
    MsgBox "處理時發生錯誤: " & Err.Description, vbCritical
    Resume Handle_Exit
End Function

Public Function HandleRenameNode() As Boolean
    On Error GoTo Handle_Error
    Dim tvw As TreeView
    Dim selectedNode As Node
    Dim newName As String
    
    Set tvw = Screen.ActiveForm.ActiveControl
    If TypeName(tvw) <> "TreeView" Then Exit Function
    
    Set selectedNode = tvw.SelectedItem
    If selectedNode Is Nothing Then Exit Function
    
    newName = InputBox("請輸入新的節點名稱:", "重命名", selectedNode.text)
    If StrPtr(newName) <> 0 Then ' 檢查用户是否點擊了取消
        selectedNode.text = newName
    End If
    
Handle_Exit:
    Exit Function
Handle_Error:
    MsgBox "處理時發生錯誤: " & Err.Description, vbCritical
    Resume Handle_Exit
End Function

Public Function HandleDeleteNode() As Boolean
    On Error GoTo Handle_Error
    Dim tvw As TreeView
    Dim selectedNode As Node
    
    Set tvw = Screen.ActiveForm.ActiveControl
    If TypeName(tvw) <> "TreeView" Then Exit Function
    
    Set selectedNode = tvw.SelectedItem
    If selectedNode Is Nothing Then Exit Function
    
    If MsgBox("確定要刪除節點 '" & selectedNode.text & "' 及其所有子節點嗎?", _
              vbQuestion + vbYesNo, "確認刪除") = vbYes Then
        tvw.Nodes.Remove selectedNode.Index
    End If
    
Handle_Exit:
    Exit Function
Handle_Error:
    MsgBox "處理時發生錯誤: " & Err.Description, vbCritical
    Resume Handle_Exit
End Function

代碼要點:
✅ OnAction = "=FunctionName()": 這是將菜單按鈕與VBA函數關聯的核心。=號表示調用一個函數，且該函數必須是標準模塊中的Public Function。
✅ Screen.ActiveForm.ActiveControl: 這種方式使回調函數更具通用性，它會作用於當前活動窗體上處於活動狀態的TreeView控件。
✅ 錯誤處理: 為每個回調函數添加了基礎的錯誤處理，增強了代碼的健壯性。

步驟二：在窗體中響應鼠標事件
現在，我們需要在包含TreeView控件的窗體中編寫代碼，以捕獲右鍵點擊並顯示我們創建的菜單。打開窗體設計視圖，選中你的TreeView控件（假設其名稱為 tvwDemo）。

在窗體的代碼模塊中，添加以下事件處理過程。

' 窗體加載時，確保右鍵菜單已創建
Private Sub Form_Load()
    CreateOrUpdateContextMenu
End Sub

' TreeView的MouseDown事件處理
Private Sub tvwDemo_MouseDown(ByVal Button As Integer, ByVal Shift As Integer, ByVal x As Long, ByVal y As Long)
    ' Button = 2 代表鼠標右鍵
    If Button = 2 Then
        Dim hitNode As Node
        
        ' 使用HitTest方法獲取鼠標座標下的節點
        Set hitNode = Me.tvwDemo.HitTest(x, y)
        
        ' 如果鼠標確實點擊在一個節點上
        If Not hitNode Is Nothing Then
            ' 將被右擊的節點設置為當前選中項。
            ' 這是為了讓標準模塊中的回調函數能通過 tvw.SelectedItem 獲取到正確的操作對象。
            hitNode.Selected = True
        End If
        
        ' 顯示之前創建的彈出式菜單
        Application.CommandBars("tvwCustomPopup").ShowPopup
    End If
End Sub

代碼要點:
✅Form_Load: 在窗體加載時調用 CreateOrUpdateContextMenu，確保菜單在需要時總是可用的。✅hitNode.Selected = True: 這是非常關鍵的一步。在顯示菜單之前，我們主動將被右擊的節點設置為選中狀態。
這樣，當用户點擊菜單項時，執行的回調函數通過 tvw.SelectedItem 就能準確地獲取到目標節點。

🚀總結通過結合使用 MouseDown 事件、HitTest 方法和 CommandBars 對象，我們可以為Access的TreeView控件構建出功能強大且交互自然的右鍵菜單。這種純VBA的實現方式無需外部依賴，兼容性好，能夠顯著提升應用程序的用户體驗和專業性。掌握此技術後，開發者可以根據具體業務需求，靈活地擴展出更多複雜的上下文操作。
覺得有用請點贊👍 + 轉發，讓更多人的學習Access！