VSTO Outlook：如何检测活动窗口中的鼠标左键抬起事件

Outlook VSTO本身没有直接提供鼠标左键抬起事件的订阅机制，确实需要通过Windows API的窗口子类化（Window Subclassing）来捕获WM_LBUTTONUP消息实现，以下是具体实现步骤和代码示例：

核心原理 #

Windows所有窗口通过消息机制处理用户输入，WM_LBUTTONUP（常量值0x0202）是系统发送给窗口的鼠标左键抬起消息。我们可以通过窗口子类化替换目标Outlook窗口的消息处理过程，拦截并处理该消息。

具体实现步骤 #

1. 获取Outlook活动窗口句柄：通过Outlook对象模型的Explorer.HWND或Inspector.HWND属性获取当前激活窗口的句柄。
2. 设置窗口子类化：调用Windows API的SetWindowSubclass函数，将自定义的消息处理函数绑定到目标窗口。
3. 处理鼠标抬起消息：在自定义回调函数中捕获WM_LBUTTONUP消息，执行你的业务逻辑。
4. 清理子类化：在窗口失活或Add-in关闭时，调用RemoveWindowSubclass移除子类化，避免内存泄漏。

C#代码示例 #

using System;
using System.Runtime.InteropServices;
using Microsoft.Office.Interop.Outlook;

namespace OutlookMouseHookAddIn
{
    public partial class ThisAddIn
    {
        // 鼠标左键抬起消息常量
        private const int WM_LBUTTONUP = 0x0202;

        // Windows API函数声明
        [DllImport("user32.dll", CharSet = CharSet.Unicode)]
        private static extern bool SetWindowSubclass(IntPtr hWnd, SubclassProc dwNewProc, uint uIdSubclass, IntPtr dwRefData);

        [DllImport("user32.dll", CharSet = CharSet.Unicode)]
        private static extern bool RemoveWindowSubclass(IntPtr hWnd, SubclassProc dwNewProc, uint uIdSubclass);

        [DllImport("user32.dll", CharSet = CharSet.Unicode)]
        private static extern IntPtr DefSubclassProc(IntPtr hWnd, uint uMsg, IntPtr wParam, IntPtr lParam);

        // 子类回调委托
        private delegate IntPtr SubclassProc(IntPtr hWnd, uint uMsg, IntPtr wParam, IntPtr lParam, uint uIdSubclass, IntPtr dwRefData);

        // 保存回调实例（防止被GC回收）
        private SubclassProc _subclassCallback;
        private IntPtr _activeOutlookWindow;
        private const uint _subclassId = 1;

        private void ThisAddIn_Startup(object sender, EventArgs e)
        {
            // 监听Outlook窗口激活/失活事件
            Application.WindowActivate += OnWindowActivate;
            Application.WindowDeactivate += OnWindowDeactivate;
        }

        private void OnWindowActivate(Explorer explorer, Inspector inspector)
        {
            // 获取当前激活窗口的句柄
            _activeOutlookWindow = explorer != null ? new IntPtr(explorer.HWND) : new IntPtr(inspector.HWND);
            
            // 初始化回调函数
            _subclassCallback = new SubclassProc(OutlookWindowMessageHandler);
            
            // 绑定子类化
            SetWindowSubclass(_activeOutlookWindow, _subclassCallback, _subclassId, IntPtr.Zero);
        }

        private void OnWindowDeactivate(Explorer explorer, Inspector inspector)
        {
            // 移除子类化，释放资源
            if (_activeOutlookWindow != IntPtr.Zero)
            {
                RemoveWindowSubclass(_activeOutlookWindow, _subclassCallback, _subclassId);
                _activeOutlookWindow = IntPtr.Zero;
            }
        }

        private IntPtr OutlookWindowMessageHandler(IntPtr hWnd, uint uMsg, IntPtr wParam, IntPtr lParam, uint uIdSubclass, IntPtr dwRefData)
        {
            // 拦截鼠标左键抬起消息
            if (uMsg == WM_LBUTTONUP)
            {
                // 这里编写你的事件处理逻辑
                System.Diagnostics.Debug.WriteLine("鼠标左键抬起事件触发");
                
                // 从lParam解析鼠标位置（窗口客户区坐标）
                int mouseX = (short)lParam;
                int mouseY = (short)(lParam >> 16);
                System.Diagnostics.Debug.WriteLine($"鼠标位置：X={mouseX}, Y={mouseY}");
            }

            // 调用默认窗口消息处理过程，保证Outlook原有功能正常
            return DefSubclassProc(hWnd, uMsg, wParam, lParam);
        }

        private void ThisAddIn_Shutdown(object sender, EventArgs e)
        {
            // 程序关闭时确保清理子类化
            if (_activeOutlookWindow != IntPtr.Zero)
            {
                RemoveWindowSubclass(_activeOutlookWindow, _subclassCallback, _subclassId);
            }
        }

        #region VSTO自动生成代码
        private void InternalStartup()
        {
            Startup += ThisAddIn_Startup;
            Shutdown += ThisAddIn_Shutdown;
        }
        #endregion
    }
}

注意事项 #

• 64位兼容性：使用SetWindowSubclass而非旧的SetWindowLongPtr，该API原生支持32/64位系统，避免指针长度问题。
• 内存泄漏：必须在窗口失活或Add-in关闭时调用RemoveWindowSubclass，否则会导致Outlook进程内存泄漏。
• 权限匹配：如果Outlook以管理员权限运行，你的VSTO Add-in也需要以管理员权限启动，否则SetWindowSubclass调用会失败。
• UI线程阻塞：自定义消息回调中不要执行耗时操作，建议通过Task.Run异步处理，避免卡顿Outlook界面。

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