VB 預設的事件模型僅涵蓋常見互動 (Click、Change、KeyPress 等)。若需攔截系統未封裝的訊息 (如 `WM_RBUTTONDOWN`、`WM_MOUSEWHEEL`、`WM_HOTKEY`),或在不修改原控制項原始碼下擴展行為,必須使用 子類別化 技術。本文詳細說明原理、API 宣告、三階段流程、完整程式碼範例與除錯防炸技巧。
Windows 視窗程序 (`Window Procedure`) 處理所有送達視窗的訊息。子類別化透過 SetWindowLong(hwnd, GWL_WNDPROC, newProc) 將原始視窗程序位址替換為自訂函數 (`wndproc`),並在自訂函數中:
CallWindowProc(oldProc, ...) 轉交原始程序結束時用 SetWindowLong(hwnd, GWL_WNDPROC, oldProc) 還原。
Option Explicit
'--- API 宣告 ---
Private Declare Function SetWindowLong Lib "user32" Alias "SetWindowLongA" _
(ByVal hwnd As Long, ByVal nIndex As Long, ByVal dwNewLong As Long) As Long
Private Declare Function GetWindowLong Lib "user32" Alias "GetWindowLongA" _
(ByVal hwnd As Long, ByVal nIndex As Long) As Long
Private Declare Function CallWindowProc Lib "user32" Alias "CallWindowProcA" _
(ByVal lpPrevWndFunc As Long, ByVal hwnd As Long, ByVal Msg As Long, _
ByVal wParam As Long, ByVal lParam As Long) As Long
'--- 常數 ---
Public Const GWL_WNDPROC = -4
Public Const WM_MOUSEMOVE = &H200
Public Const WM_LBUTTONDOWN = &H201
Public Const WM_RBUTTONDOWN = &H204
Public Const WM_RBUTTONUP = &H205
Public Const WM_KEYDOWN = &H100
Public Const WM_HOTKEY = &H312
'--- 全域變數:儲存原始視窗程序位址 ---
Public prevWndProc As Long
Public Function WndProc(ByVal hwnd As Long, ByVal uMsg As Long, _
ByVal wParam As Long, ByVal lParam As Long) As Long
Select Case uMsg
Case WM_RBUTTONDOWN
' 範例:右鍵彈出自訂選單
frmMain.mnuPopup.Popup MouseX, MouseY
WndProc = 0 ' 訊息已處理,不再傳遞
Exit Function
Case WM_HOTKEY
' 範例:全域熱鍵 (需配合 RegisterHotKey)
If wParam = 1 Then MsgBox "Hotkey 1 triggered!"
WndProc = 0
Exit Function
Case Else
' 其他訊息轉交原始程序
WndProc = CallWindowProc(prevWndProc, hwnd, uMsg, wParam, lParam)
End Select
End Function
'--- 表單 Form1 ---
Private Sub Form_Load()
' 啟動子類別化:攔截 Combo1 的訊息
Call StartSubclass(Combo1.hwnd)
End Sub
Private Sub Form_Unload(Cancel As Integer)
' 關鍵:表單卸載前必須還原,否則 IDE 當機
Call EndSubclass(Combo1.hwnd)
End Sub
Private Sub StartSubclass(hwnd As Long)
prevWndProc = GetWindowLong(hwnd, GWL_WNDPROC)
Dim ret As Long
ret = SetWindowLong(hwnd, GWL_WNDPROC, AddressOf WndProc)
If ret = 0 Then MsgBox "Subclass failed: " & Err.LastDllError
End Sub
Private Sub EndSubclass(hwnd As Long)
Dim ret As Long
ret = SetWindowLong(hwnd, GWL_WNDPROC, prevWndProc)
If ret = 0 Then MsgBox "Unsubclass failed: " & Err.LastDllError
End Sub
Case WM_KEYDOWN
If (wParam = vbKeyReturn) And (GetKeyState(vbKeyControl) < 0) Then
SendMessage hwnd, WM_CHAR, vbCr, 0
SendMessage hwnd, WM_CHAR, vbLf, 0
WndProc = 0
Exit Function
End If
Case WM_MOUSEWHEEL
' 將滾輪事件轉發給下拉清單的 ListBox (需取得子視窗 hwnd)
' 此處略,關鍵在於識別下拉狀態與目標 hwnd
WndProc = CallWindowProc(prevWndProc, hwnd, uMsg, wParam, lParam)
Private Declare Function RegisterHotKey Lib "user32" _
(ByVal hwnd As Long, ByVal id As Long, ByVal fsModifiers As Long, ByVal vk As Long) As Long
Private Declare Function UnregisterHotKey Lib "user32" _
(ByVal hwnd As Long, ByVal id As Long) As Long
Private Sub Form_Load()
' 註冊 Alt+F1 (ID=1)
RegisterHotKey Me.hwnd, 1, &H1, vbKeyF1 ' MOD_ALT = &H1
Call StartSubclass(Me.hwnd) ' 攔截表單訊息以接收 WM_HOTKEY
End Sub
Private Sub Form_Unload(Cancel As Integer)
UnregisterHotKey Me.hwnd, 1
Call EndSubclass(Me.hwnd)
End Sub
將 `StartSubclass`/`EndSubclass` 的 `hwnd` 參數化,即可套用至任何擁有 `hwnd` 屬性的控制項:`TextBox`、`ListView`、`TreeView`、`RichTextBox`、甚至表單本身 (`Me.hwnd`)。
子類別化是 VB 突破事件模型限制、直通 Windows 訊息泵的終極武器。掌握「攔截 → 處理 → 轉發 → 還原」四步驟,並嚴守除錯鐵律,即可為舊版 VB 應用注入現代化互動體驗 (右鍵選單、熱鍵、滾輪支援、拖放優化等)。遷移至 .NET 後,同樣概念對應 `WndProc` 覆寫、`IMessageFilter`、`Application.AddMessageFilter`,核心思維不變。