C#中ToolTip不显示问题排查：子窗体按钮悬停无提示

我之前处理过不少Bunifu控件在子窗体中ToolTip失效的问题，结合你的描述和代码片段，应该是这几个常见原因之一，给你几个具体的排查和解决思路：

可能的原因及解决方案 #

• ToolTip未关联到子窗体控件
  主窗体的ToolTip默认只对主窗体的控件生效，你在子窗体动态创建的按钮，需要绑定到子窗体专属的ToolTip实例上。如果直接用主窗体的ToolTip，它的Owner是主窗体，无法识别子窗体的控件。
  解决代码示例：

  // 在TVShowPanel类中声明ToolTip实例
  private ToolTip _subFormToolTip;
  
  private void TVShowPanel_Load(object sender, EventArgs e)
  {
      // 初始化子窗体的ToolTip，可同步主窗体的设置
      _subFormToolTip = new ToolTip
      {
          AutoPopDelay = 5000,
          InitialDelay = 100,
          ReshowDelay = 500,
          ShowAlways = true // 可选，确保即使控件不可用时也能显示
      };
  
      Bunifu.Framework.UI.BunifuThinButton2 dd = new Bunifu.Framework.UI.BunifuThinButton2
      {
          Tag = ll[0].episodeTitle + "\n" + ll[0].episodeOverview,
          // 你的其他按钮属性设置...
      };
  
      // 必须将按钮添加到子窗体的控件集合中
      this.Controls.Add(dd);
      // 关联ToolTip与按钮，使用Tag中的文本作为提示内容
      _subFormToolTip.SetToolTip(dd, dd.Tag.ToString());
  }
  

• 动态按钮未加入子窗体控件树
  从你的代码片段看不到将按钮添加到子窗体控件的代码，如果只是实例化了按钮但没加入控件集合，ToolTip的消息触发机制找不到这个控件，自然不会显示提示。
  解决：在创建按钮后，执行this.Controls.Add(dd)（如果是添加到子窗体里的Panel等容器，就用yourPanelName.Controls.Add(dd)）。

• Bunifu控件的Hover事件被拦截
  部分自定义的Bunifu控件可能重写了鼠标悬停相关事件，导致ToolTip的默认触发逻辑失效。这种情况下可以手动绑定Hover事件，主动调用ToolTip显示：

  dd.MouseHover += (sender, e) =>
  {
      _subFormToolTip.Show(dd.Tag.ToString(), dd, new Point(dd.Width / 2, dd.Height));
  };
  

• 子窗体层级或遮挡问题
  检查子窗体的TopLevel属性是否为true（非MDI子窗体默认是true），同时确认子窗体没有被其他控件或窗体遮挡，这可能导致ToolTip被覆盖无法显示。

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