使用C# VSTO如何检测Word文档中被点击的超链接

Word 的互操作对象模型内置了超链接点击的公开事件，不需要引入额外的鼠标钩子等侵入式方案，即可精准识别用户点击的超链接、读取其目标地址。

核心实现逻辑 #

通过订阅 Word 应用级别的HyperlinkClick事件，即可在用户点击任意文档内超链接时触发回调，事件会直接传递点击位置对应的选中范围，从范围中即可提取关联的超链接对象，读取其存储的目标地址。

事件订阅方式 #

在加载项的ThisAddIn启动事件中完成事件绑定：

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    // 强转Application对象为事件接口，解决PIA层的事件暴露兼容问题
    Word.ApplicationEvents4_Event appEvents = Globals.ThisAddIn.Application as Word.ApplicationEvents4_Event;
    appEvents.HyperlinkClick += OnHyperlinkClicked;
}

点击事件回调实现 #

在回调方法中提取被点击的超链接信息，即可实现弹出提示的效果：

private void OnHyperlinkClicked(Word.Selection sel, ref bool cancel)
{
    Word.Range clickRange = sel.Range;
    // 遍历点击位置范围内的所有超链接
    foreach (Word.Hyperlink link in clickRange.Hyperlinks)
    {
        // 直接读取超链接创建时传入的目标地址
        string linkTarget = link.Address;
        // 弹出消息框展示目标地址
        System.Windows.Forms.MessageBox.Show($"当前点击的超链接目标为：{linkTarget}");
        
        // 可选参数：如果需要阻断超链接的默认跳转行为，将cancel设为true
        cancel = true;
    }
}

优化适配建议 #

• 给插件创建的超链接加自定义标识：在你原有添加超链接的代码中，给生成的Hyperlink对象打专属标记，在事件回调中先判断标记，避免误捕获文档中原生的超链接点击行为

  // 原有添加超链接代码的基础上增加标记
  Microsoft.Office.Interop.Word.Hyperlink hp = (Microsoft.Office.Interop.Word.Hyperlink)objRange.Hyperlinks.Add(objRange, "1");
  hp.Name = "CustomAddinHyperlink";
  

• 及时释放COM对象：事件回调中遍历获取到的Hyperlink、Range对象，使用完成后调用System.Runtime.InteropServices.Marshal.ReleaseComObject()释放，避免Word进程异常驻留内存
• 边界场景处理：如果超链接跨多段落存在，直接从点击位置的Range提取的超链接会自动匹配最贴近点击位置的实例，不需要额外做坐标换算

注意：该事件兼容所有VSTO支持的Word版本，不需要针对不同Office版本做单独的适配逻辑。

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