一样平常开辟记录分享——C#控件ToolTip实现分栏显示内容 ...

需求来源

需要在鼠标浮动到指定位置后提示出详细的信息，一开始利用的tooltip实现，但是内里的内容效果并不理想，需要有条理性，于是就想到能不能将展示的东西分列。
实现思路

利用两个字符串数据接收通过字符串切割后的内容，然后通过在tooltip的draw事件绘制时将内容分为两次绘制。
实施

自定封装一个ToolTip控件，继续ToolTIp然后添加两个事件，分别时Draw 和Popup
Draw 和 Popup 这两个事件在 ToolTip 类中饰演着重要的脚色，用于自定义工具提示的显示和绘制。
Draw 事件在工具提示需要绘制时触发。通过处理这个事件，可以自定义工具提示的外观和内容。

• 作用：
  
  
  
  • 自定义绘制工具提示：在处理 Draw 事件时，可以完全控制工具提示的绘制，包括背景颜色、边框、文本内容和文本样式等。
    
  • 实现高级图形效果：可以利用 Graphics 对象来实现复杂的绘制效果，比如渐变色、图片、各种形状等。
    
  
  
• 利用场景：
  
  
  
  • 当默认的工具提示外观不能满足需求时，可以通过 Draw 事件自定义绘制工具提示。
    
  • 需要在工具提示中显示非文本内容（如图像、图表）时，可以在 Draw 事件中实现。
    
  
  

Popup 事件在工具提示显示之前触发。通过处理这个事件，可以动态调整工具提示的巨细和内容。

• 作用：
  
  
  
  • 动态调整工具提示巨细：在处理 Popup 事件时，可以根据内容的巨细动态设置工具提示的尺寸，以确保内容完全显示。
    
  • 准备绘制环境：可以在 Popup 事件中进行一些准备工作，比如盘算文本的最大宽度和高度，为后续的 Draw 事件做准备。
    
  
  
• 利用场景：
  
  
  
  • 需要根据内容动态调整工具提示的巨细时，可以在 Popup 事件中进行盘算和设置。
    
  • 需要在工具提示显示前进行一些准备工作，比如加载图片、盘算文本尺寸等，可以在 Popup 事件中处理。
    
  
  

1. using System;
2. using System.Drawing;
3. using System.Windows.Forms;
5. namespace Test1
6. {
7.     // 自定义工具提示类，继承自 ToolTip
8.     public class CustomToolTip : ToolTip
9.     {
10.         private string[] Column1; // 用于存储第一列的文本数组
11.         private string[] Column2; // 用于存储第二列的文本数组
12.         private Font TextFont; // 工具提示文本的字体
13.         // 记录第一列的宽度
14.         private int Column1MaxWidth = 0;
15.                
16.         // 构造函数，初始化自定义工具提示
17.         public CustomToolTip()
18.         {
19.             TextFont = new Font("微软雅黑", 15.0f); // 设置字体为“微软雅黑”，大小为15
20.             this.OwnerDraw = true; // 启用自定义绘制工具提示
21.             this.Draw += new DrawToolTipEventHandler(OnDraw); // 订阅 Draw 事件
22.             this.Popup += new PopupEventHandler(OnPopup); // 订阅 Popup 事件
23.         }
25.         // 设置工具提示的内容，将其拆分为两列
26.         public void SetContent(string content)
27.         {
28.             var parts = content.Split(new string[] { "," }, StringSplitOptions.None); // 按逗号拆分内容
29.             int midPoint = (parts.Length + 1) / 2; // 计算拆分成两列的中间点
31.             Column1 = new string[midPoint]; // 初始化第一列数组
32.             Column2 = new string[parts.Length - midPoint]; // 初始化第二列数组
34.             // 填充列数组
35.             for (int i = 0; i < parts.Length; i++)
36.             {
37.                 if (i < midPoint)
38.                 {
39.                     Column1[i] = parts[i];
40.                 }
41.                 else
42.                 {
43.                     Column2[i - midPoint] = parts[i];
44.                 }
45.             }
46.         }
48.         // 自定义工具提示的绘制事件处理程序
49.         private void OnDraw(object sender, DrawToolTipEventArgs e)
50.         {
51.             e.DrawBackground(); // 绘制工具提示的背景
52.             e.DrawBorder(); // 绘制工具提示的边框
54.             Brush brush = Brushes.Black; // 用于绘制文本的画笔
55.             Rectangle rct2 = e.Bounds; // 工具提示的边界
56.             e.Graphics.FillRectangle(Brushes.Bisque, rct2); // 用浅橙色填充背景
57.             e.Graphics.DrawRectangle(Pens.DarkGray, new Rectangle(0, 0, rct2.Width - 1, rct2.Height - 1)); // 绘制边框
59.             // 绘制第一列文本
60.             for (int i = 0; i < Column1.Length; i++)
61.             {
62.                 e.Graphics.DrawString(Column1[i], TextFont, brush, new PointF(5, i * 25));
63.             }
65.             // 绘制第二列文本
66.             for (int i = 0; i < Column2.Length; i++)
67.             {
68.                 e.Graphics.DrawString(Column2[i], TextFont, brush, new PointF(Column1MaxWidth, i * 25));
69.             }
70.         }
72.         // 在工具提示显示之前计算其大小的事件处理程序
73.         private void OnPopup(object sender, PopupEventArgs e)
74.         {
75.             int Column2MaxWidth = 0; // 用于存储第二列的最大宽度
76.             int maxHeight = 0; // 用于存储工具提示的最大高度
78.             // 计算第一列的最大宽度和高度
79.             foreach (var text in Column1)
80.             {
81.                 var sz = TextRenderer.MeasureText(text, TextFont);
82.                 if (sz.Width > Column1MaxWidth)
83.                     Column1MaxWidth = sz.Width;
84.                 maxHeight += sz.Height;
85.             }
87.             // 计算第二列的最大宽度
88.             foreach (var text in Column2)
89.             {
90.                 var sz = TextRenderer.MeasureText(text, TextFont);
91.                 if (sz.Width > Column2MaxWidth)
92.                     Column2MaxWidth = sz.Width;
93.             }
95.             // 确保高度适应两列中较高的一列
96.             maxHeight = Math.Max(maxHeight, Column2.Length * TextRenderer.MeasureText("A", TextFont).Height);
97.             e.ToolTipSize = new Size(Column1MaxWidth + Column2MaxWidth + 20, maxHeight + 30); // 设置工具提示大小，并添加一些间距
98.         }
99.     }
100. }

复制代码

这里对字符串的分割是根据,来的，根据个人需要修改SetContent方法中切割字符，固然也可以封装一下，这里本人偷懒了。
下面是利用的方式，先在我们窗体中创建一个自定义的Tooltip对象，详细利用就是先设置SetContent方法将要显示的内容传递进去。末了将要tooltip关联的控件对象绑定就行了

1.   private CustomToolTip custom = new CustomToolTip();
2.         private void Form1_Load(object sender, EventArgs e)
3.         {
5.             string aa = $"工作人员姓名：aaa,出勤地点：aaa333344445555555555," +
6.                $"工号：aaa,出勤时间：aaa," +
7.                $"手机：aaaaaaaa,本站时间：aaa," +
8.                $"站名：aaa,工作班制：aaa," +
9.                $"当前已工作时间：aaa,班制时长：aaa1111," +
10.                $"工作人员所属部门：aaa";
11.             custom.SetContent(aa);
12.              custom.SetToolTip(button1,aa);//这里传递第二个参数只要是字符串就行，因为在SetContent方法时已经设置好要显示的内容了。
13.         }

复制代码

请看VCR

等等别走，有优化

鉴于上面我们利用的在From_Load方法中去利用自定义tip时调用SetToolTip时第二个参数传递有些冗余，这里把自定义的tip控件给优化了一下,优化虽小也是进步

1. using System;
2. using System.Drawing;
3. using System.Windows.Forms;
5. namespace Test1
6. {
7.     // 自定义工具提示类，继承自 ToolTip
8.     public class CustomToolTip : ToolTip
9.     {
10.         private string[] Column1; // 用于存储第一列的文本数组
11.         private string[] Column2; // 用于存储第二列的文本数组
12.         private Font TextFont; // 工具提示文本的字体
13.         priavte Control ParentCtrl;//父窗体控件
14.         // 记录第一列的宽度
15.         private int Column1MaxWidth = 0;
17.         // 构造函数，初始化自定义工具提示
18.         public CustomToolTip()
19.         {
20.             TextFont = new Font("微软雅黑", 15.0f); // 设置字体为“微软雅黑”，大小为15
21.             this.OwnerDraw = true; // 启用自定义绘制工具提示
22.             this.Draw += new DrawToolTipEventHandler(OnDraw); // 订阅 Draw 事件
23.             this.Popup += new PopupEventHandler(OnPopup); // 订阅 Popup 事件
24.         }
26.         // 设置工具提示的内容，将其拆分为两列
27.         private void SetContent(string content)
28.         {
29.             var parts = content.Split(new string[] { "," }, StringSplitOptions.None); // 按逗号拆分内容
30.             int midPoint = (parts.Length + 1) / 2; // 计算拆分成两列的中间点
32.             Column1 = new string[midPoint]; // 初始化第一列数组
33.             Column2 = new string[parts.Length - midPoint]; // 初始化第二列数组
35.             // 填充列数组
36.             for (int i = 0; i < parts.Length; i++)
37.             {
38.                 if (i < midPoint)
39.                 {
40.                     Column1[i] = parts[i];
41.                 }
42.                 else
43.                 {
44.                     Column2[i - midPoint] = parts[i];
45.                 }
46.             }
47.         }
49.         // 自定义工具提示的绘制事件处理程序
50.         private void OnDraw(object sender, DrawToolTipEventArgs e)
51.         {
52.             e.DrawBackground(); // 绘制工具提示的背景
53.             e.DrawBorder(); // 绘制工具提示的边框
55.             Brush brush = Brushes.Black; // 用于绘制文本的画笔
56.             Rectangle rct2 = e.Bounds; // 工具提示的边界
57.             e.Graphics.FillRectangle(Brushes.Bisque, rct2); // 用浅橙色填充背景
58.             e.Graphics.DrawRectangle(Pens.DarkGray, new Rectangle(0, 0, rct2.Width - 1, rct2.Height - 1)); // 绘制边框
60.             // 绘制第一列文本
61.             for (int i = 0; i < Column1.Length; i++)
62.             {
63.                 e.Graphics.DrawString(Column1[i], TextFont, brush, new PointF(5, i * 25));
64.             }
66.             // 绘制第二列文本
67.             for (int i = 0; i < Column2.Length; i++)
68.             {
69.                 e.Graphics.DrawString(Column2[i], TextFont, brush, new PointF(Column1MaxWidth, i * 25));
70.             }
71.         }
73.         // 在工具提示显示之前计算其大小的事件处理程序
74.         private void OnPopup(object sender, PopupEventArgs e)
75.         {
76.             int Column2MaxWidth = 0; // 用于存储第二列的最大宽度
77.             int maxHeight = 0; // 用于存储工具提示的最大高度
78.             //设置将文本拆分两个数组，用于后期显示为两列---在这里通过tip控件自带的GetToolTip方法获取提示文本内容然后进行拆分初始化
79.                         SetContent(this.GetToolTip(ParentCtrl));
80.             // 计算第一列的最大宽度和高度
81.             foreach (var text in Column1)
82.             {
83.                 var sz = TextRenderer.MeasureText(text, TextFont);
84.                 if (sz.Width > Column1MaxWidth)
85.                     Column1MaxWidth = sz.Width;
86.                 maxHeight += sz.Height;
87.             }
89.             // 计算第二列的最大宽度
90.             foreach (var text in Column2)
91.             {
92.                 var sz = TextRenderer.MeasureText(text, TextFont);
93.                 if (sz.Width > Column2MaxWidth)
94.                     Column2MaxWidth = sz.Width;
95.             }
97.             // 确保高度适应两列中较高的一列
98.             maxHeight = Math.Max(maxHeight, Column2.Length * TextRenderer.MeasureText("A", TextFont).Height);
99.             e.ToolTipSize = new Size(Column1MaxWidth + Column2MaxWidth + 20, maxHeight + 30); // 设置工具提示大小，并添加一些间距
100.         }
101.     }
102. }

复制代码

1.         private CustomToolTip custom ;
2.         public Form1()
3.         {
4.             InitializeComponent();
5.            
6.         }
7.         private void Form1_Load(object sender, EventArgs e)
8.         {
9.                         custom = new CustomToolTip(button1);
10.             string aa = $"工作人员姓名：aaa,出勤地点：aaa333344445555555555," +
11.                $"工号：aaa,出勤时间：aaa," +
12.                $"手机：aaaaaaaa,本站时间：aaa," +
13.                $"站名：aaa,工作班制：aaa," +
14.                $"当前已工作时间：aaa,班制时长：aaa1111," +
15.                $"工作人员所属部门：aaa";
16.             custom.SetToolTip(button1,aa);
17.         }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。