VSTO Word插件如何检测用户点击文档区域外的界面位置

VSTO框架本身没有提供检测文档编辑区外点击事件的原生接口，你目前采用的低级别鼠标钩子方案是可行的，只需要在现有钩子回调逻辑中补充坐标校验规则，即可实现需求。

核心实现逻辑 #

你需要在已有的鼠标点击事件判断分支中，补充坐标范围校验，步骤如下：

• 先确认点击事件发生在当前激活的Word主窗口范围内，排除点击其他应用的场景
• 再获取Word文档编辑区的屏幕坐标范围，判断点击坐标是否落在编辑区外，符合条件即可判定为点击了Ribbon、底部状态栏等目标区域

现有代码修改说明 #

你贴出的鼠标钩子回调代码已经可以正常获取鼠标点击的屏幕坐标，只需要在点击事件的判断分支中补充坐标校验逻辑即可，修改后的参考代码如下：

Private Function MouseHookCallback(ByVal nCode As Integer, ByVal wParam As IntPtr, ByVal lParam As IntPtr) As IntPtr
    If nCode = 0 Then
        Dim mouseHookStruct = CType(Marshal.PtrToStructure(lParam, GetType(SafeNativeMethods.MouseHookStructEx)), SafeNativeMethods.MouseHookStructEx)
        Dim message = CType(wParam, SafeNativeMethods.WindowMessages)
        Debug.WriteLine("{0} 事件触发，坐标位置 {1} - {2}", message, mouseHookStruct.pt.X, mouseHookStruct.pt.Y)
        
        ' 检测到鼠标按键点击/滚轮事件
        If message = WindowMessages.WM_LBUTTONDOWN Or message = WindowMessages.WM_MBUTTONDOWN Or message = WindowMessages.WM_RBUTTONDOWN Or _
            message = WindowMessages.WM_MOUSEHWHEEL Or message = WindowMessages.WM_MOUSEWHEEL Then
            
            ' 新增：坐标校验逻辑
            If IsClickOnWordNonDocumentArea(mouseHookStruct.pt.X, mouseHookStruct.pt.Y) Then
                ' 符合需求的点击事件触发，此处写你的业务逻辑
                Debug.WriteLine("检测到点击文档外区域")
            End If
        End If
        
        If message = WindowMessages.WM_MOUSEMOVE Then
            Debug.WriteLine("鼠标移动事件触发，ncode=> " & nCode)
        End If
    End If

    Return SafeNativeMethods.CallNextHookEx(_hookIdKeyboard, nCode, wParam, lParam)
End Function

其中IsClickOnWordNonDocumentArea是你需要自行实现的坐标校验方法，参考实现逻辑：

1. 调用Win32 API GetWindowRect获取当前Word主窗口的屏幕坐标范围，先判断点击坐标是否在Word窗口内
2. 两种方式获取文档编辑区坐标：
   • 方案一：调用VSTO自带方法Globals.ThisAddIn.Application.ActiveWindow.PointsToScreenPixelsX/PointsToScreenPixelsY，把文档编辑区的边界从文档坐标转为屏幕坐标
   • 方案二：调用Win32 API FindWindowEx查找Word窗口内的文档编辑区子窗口（默认类名为_WwG，可通过Spy++确认对应Word版本的类名），再调用GetWindowRect获取编辑区的屏幕坐标
3. 最终判断：点击坐标在Word主窗口范围内，且不在文档编辑区坐标范围内，即返回True

注意事项 #

• 钩子使用完毕必须释放，建议在AddIn的Shutdown事件中调用UnhookWindowsHookEx卸载钩子，避免内存泄漏或Word崩溃
• 若不需要监听全局鼠标事件，建议使用线程级鼠标钩子替代全局钩子，只监听当前Word进程的鼠标消息，性能和兼容性更好
• 尽量优先使用VSTO提供的窗口坐标转换方法获取编辑区范围，比匹配窗口类名的兼容性更高，可适配不同版本的Word客户端

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