如何用C#为RichTextBox中的特定文本添加ToolTip？

我懂你的困扰——你现在的代码是把ToolTip绑定给了整个RichTextBox控件，所以不管鼠标放在控件哪里都会显示提示，但你只想让那些匹配到的SendLuaScript、SendCSharpScript这类文本才触发ToolTip对吧？

这是因为原生的ToolTip控件是绑定到控件的，而不是控件内部的特定文本片段。要实现针对文本区域的提示，我们得换个思路：跟踪鼠标位置，判断它是否落在目标文本范围内，再动态显示/隐藏ToolTip。

具体实现步骤 #

1. 先保存匹配结果
   首先把所有匹配到的文本位置存起来，避免每次鼠标移动都重新执行正则匹配，提升性能：

   // 在窗体类里定义全局变量，保存匹配项和ToolTip实例
   private List<Match> _errorTextMatches = new List<Match>();
   private ToolTip _customToolTip;
   
   // 用于加载匹配结果并设置文本颜色的方法
   private void UpdateErrorTextMarkup()
   {
       string targetPattern = @"SendLuaScript|SendCSharpScript|SendRubyScript";
       // 把匹配结果转成List方便后续操作
       _errorTextMatches = Regex.Matches(richTextBox1.Text, targetPattern)
                               .Cast<Match>()
                               .ToList();
   
       // 给匹配到的文本设置灰色（和你原来的逻辑一致）
       foreach (Match match in _errorTextMatches)
       {
           richTextBox1.SelectionStart = match.Index;
           richTextBox1.SelectionLength = match.Length;
           richTextBox1.SelectionColor = Color.DarkGray;
       }
   }
   

2. 监听鼠标移动事件，动态控制ToolTip
   给RichTextBox添加MouseMove事件，每次鼠标移动时判断当前位置是否在目标文本范围内：

   private void richTextBox1_MouseMove(object sender, MouseEventArgs e)
   {
       // 获取鼠标位置对应的字符索引
       int currentCharIndex = richTextBox1.GetCharIndexFromPosition(e.Location);
   
       // 检查当前字符是否落在某个匹配的文本区域内
       var matchedText = _errorTextMatches.FirstOrDefault(
           m => currentCharIndex >= m.Index && currentCharIndex < m.Index + m.Length
       );
   
       if (matchedText != null)
       {
           // 显示ToolTip，位置设置在鼠标附近
           _customToolTip.IsBalloon = true;
           _customToolTip.ToolTipIcon = ToolTipIcon.Error;
           _customToolTip.Show(
               "ERROR. You must use void SendLuaScript.",
               richTextBox1,
               e.X + 15,
               e.Y + 15,
               2000 // 可选：设置提示显示的时长，单位毫秒
           );
       }
       else
       {
           // 不在目标文本上时，隐藏ToolTip
           _customToolTip.Hide(richTextBox1);
       }
   }
   

3. 初始化设置
   在窗体的构造函数或者Load事件里完成初始化：

   public YourFormName()
   {
       InitializeComponent();
       // 初始化ToolTip实例
       _customToolTip = new ToolTip();
       // 加载初始的匹配结果
       UpdateErrorTextMarkup();
       // 绑定鼠标移动事件
       richTextBox1.MouseMove += richTextBox1_MouseMove;
   }
   

额外注意点 #

• 如果RichTextBox的文本内容会动态变化，记得在文本更新后调用UpdateErrorTextMarkup()方法，重新获取匹配结果并更新文本样式。
• 可以根据需求调整ToolTip的显示位置、时长等参数，让提示更贴合你的使用场景。

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