VSTO：如何获取Range.Find.HitHighlight的查找结果相关信息？

当然可以！你现有的HitHighlight代码已经完成了高亮标记特定单词的工作，在此基础上，完全可以通过Word对象模型里的Find相关方法实现统计匹配数量、滚动定位到目标位置、展示所有匹配项这些需求。我给你逐个拆解实现思路和代码示例：

1. 统计找到的单词数量 #

你可以通过循环执行Find.Execute()来计数所有匹配项，同时还能和你原有的高亮操作结合使用：

// 先执行你原来的高亮操作
Word.Range highlightRange = Globals.ThisAddIn.Application.ActiveDocument.Range();
highlightRange.Find.HitHighlight(FindText: "dog", MatchCase: false, MatchWholeWord: true, HighlightColor: item.color);

// 统计匹配数量
int matchCount = 0;
Word.Range searchRange = Globals.ThisAddIn.Application.ActiveDocument.Range();
searchRange.Find.ClearFormatting(); // 清除之前的格式设置，避免干扰搜索
searchRange.Find.Text = "dog";
searchRange.Find.MatchCase = false;
searchRange.Find.MatchWholeWord = true;

// 循环执行查找，每次找到就计数
while (searchRange.Find.Execute())
{
    matchCount++;
}

// 展示统计结果
System.Windows.Forms.MessageBox.Show($"已高亮并找到 {matchCount} 个\"dog\"");

注意：每次执行Find.Execute()后，searchRange会自动指向当前找到的匹配内容，所以这个循环能遍历所有匹配项。

2. 滚动定位到目标匹配位置 #

如果需要滚动到某个特定的匹配项（比如第3个，或者用户选择的匹配项），可以在查找循环中定位到目标项后，将其选中并让窗口滚动到该位置：

int targetIndex = 2; // 定位到第3个匹配项（索引从0开始）
int currentIndex = 0;
Word.Range searchRange = Globals.ThisAddIn.Application.ActiveDocument.Range();
searchRange.Find.ClearFormatting();
searchRange.Find.Text = "dog";
searchRange.Find.MatchCase = false;
searchRange.Find.MatchWholeWord = true;

while (searchRange.Find.Execute())
{
    if (currentIndex == targetIndex)
    {
        // 选中匹配内容
        searchRange.Select();
        // 滚动到该位置
        Globals.ThisAddIn.Application.ActiveWindow.ScrollIntoView(searchRange);
        break; // 找到目标后退出循环
    }
    currentIndex++;
}

如果需要逐个浏览所有匹配项，你可以把这段逻辑绑定到按钮上，每次点击定位到下一个匹配项。

3. 展示所有找到的单词（带上下文） #

要展示所有匹配项及其上下文，你可以在查找循环中提取每个匹配项的前后文本，然后把这些内容汇总展示：

List<string> matchDetails = new List<string>();
Word.Range searchRange = Globals.ThisAddIn.Application.ActiveDocument.Range();
searchRange.Find.ClearFormatting();
searchRange.Find.Text = "dog";
searchRange.Find.MatchCase = false;
searchRange.Find.MatchWholeWord = true;

int matchNum = 1;
while (searchRange.Find.Execute())
{
    // 提取匹配项前后各20个字符的上下文（可根据需求调整长度）
    int startPos = Math.Max(0, searchRange.Start - 20);
    int endPos = Math.Min(Globals.ThisAddIn.Application.ActiveDocument.Content.End, searchRange.End + 20);
    Word.Range contextRange = Globals.ThisAddIn.Application.ActiveDocument.Range(startPos, endPos);
    
    // 整理成带编号的条目
    matchDetails.Add($"第 {matchNum} 个匹配：\n{contextRange.Text.Trim()}");
    matchNum++;
}

// 展示所有匹配内容
string result = string.Join("\n\n", matchDetails);
System.Windows.Forms.MessageBox.Show("找到的所有匹配项：\n\n" + result);

你还可以把这些内容展示在自定义的WinForms/WPF面板里，让用户点击条目直接定位到对应的位置，体验更好。

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