首页 > 代码库 > 【C#】使用IExtenderProvider为控件添加扩展属性，像ToolTip那样
【C#】使用IExtenderProvider为控件添加扩展属性，像ToolTip那样
申明：
- 本文适用于WinForm开发
- 文中的“控件”一词是广义上的说法，泛指包括ToolStripItem、MenuItem在内单个界面元素，并不特指继承自Control类的狭义控件
用过ToolTip这个组件的童鞋都知道这样一个现象：在VS中拖入一个ToolTip，然后点击窗体中的各种控件，在其属性窗格中就会多出一个叫ToolTip的属性出来，如图：
本文要说的就是如何像ToolTip这样，为控件“扩展”出一个属性来（之所以用引号，是因为并不是真的为控件增加了一个属性，而是在VS中看起来像那么回事）。下面通过一个实际案例来说明。
需求是这样的：当用户把鼠标指向菜单项（ToolStripMenuItem）或工具栏项（ToolStripButton、ToolStripLabel之类）的时候，在状态栏标签（ToolStripStatusLabel）中显示该项的功能说明——很多软件都这样做，比如著名的Beyond Compare，如图：
对于这个效果，很容易想到的做法是分别为各个菜单项和工具栏项（下称item）注册MouseEnter和MouseLeave事件，在enter事件中设置状态栏标签（下称viewer)的Text="item的功能描述"，在leave事件中viewer.Text=string.Empty，即将Text清空；又或者把所有的item的这俩事件分别绑定到两个总的enter和leave事件处理方法中，然后在方法中用switch区分处理；再或者，把item的功能描述填在各自的Tag属性里，然后在enter事件中只需一句viewer.Text=(sender as ToolStripItem).Tag as string即可~总之方法多多。题外，对于菜单项和工具栏项这样的ToolStripItem，它们天生就有ToolTipText属性可以设置气泡提示，但本文并不探讨气泡方式好还是状态栏方式好。
那么有没有一种方式，写一个像ToolTip这样的组件，比如叫ToolDescribe，在VS中拖入后，就能在item的属性窗格中多出一个叫Describe的属性来，直接在里面填写item的功能描述文本就完了，要能这样该有多好：
这不废话么，图都上了，能不没有么。上ToolDescribe的代码：
using System;using System.Collections.Generic;using System.ComponentModel;using System.Windows.Forms;namespace AhDung.WinForm.Controls{ /// <summary> /// 为菜单项提供【描述】这一扩展属性 /// </summary> [Description("为菜单项或控件提供描述扩展属性")] [ProvideProperty("Describe", typeof(ToolStripItem))] public class ToolDescribe : Component, IExtenderProvider { /// <summary> /// 存储所服务的ToolStripItem及其描述 /// </summary> readonly Dictionary<ToolStripItem, string> dic; /// <summary> /// 获取或设置用于显示菜单项描述的控件 /// </summary> [DefaultValue(null), Description("获取或设置用于显示菜单项描述的控件")] public Component Viewer { get; set; } /// <summary> /// 创建一个ToolDescribe类 /// </summary> public ToolDescribe() { dic = new Dictionary<ToolStripItem, string>(); } /// <summary> /// 获取菜单项描述 /// </summary> [Description("设置菜单项描述")] //虽然方法为Get，但在VS中显示为“设置”才符合理解 [DefaultValue(null)] public string GetDescribe(ToolStripItem item) { //从集合中取出该item的描述 string value; dic.TryGetValue(item, out value); return value; } /// <summary> /// 设置菜单项描述 /// </summary> public void SetDescribe(ToolStripItem item, string value) { if (item == null) { return; } //如果赋值为null或string.Empty，视为不再扩展该ToolStripItem if (string.IsNullOrEmpty(value) || value.Trim().Length == 0) { //从集合中移除该item，并取消其相关事件绑定 dic.Remove(item); item.MouseEnter -= item_MouseEnter; item.MouseLeave -= item_MouseLeave; } else { if (!dic.ContainsKey(item))//若是新添加的item，注册其相关事件 { item.MouseEnter += item_MouseEnter; item.MouseLeave += item_MouseLeave; } //添加或更改该item的描述 dic[item] = value;//这种写法对于dic中不存在的Key，会自动添加 } } //鼠标指向事件 private void item_MouseEnter(object sender, EventArgs e) { //让Viewer.Text显示item的描述 if (Viewer is ToolStripItem) { (Viewer as ToolStripItem).Text = dic[sender as ToolStripItem]; } else if (Viewer is StatusBarPanel) { (Viewer as StatusBarPanel).Text = dic[sender as ToolStripItem]; } else if (Viewer is Control) { (Viewer as Control).Text = dic[sender as ToolStripItem]; } } //鼠标移开事件 private void item_MouseLeave(object sender, EventArgs e) { //清空Viewer.Text if (Viewer is ToolStripItem) { (Viewer as ToolStripItem).Text = string.Empty; } else if (Viewer is StatusBarPanel) { (Viewer as StatusBarPanel).Text = string.Empty; } else if (Viewer is Control) { (Viewer as Control).Text = string.Empty; } } /// <summary> /// 是否可为某对象扩展属性 /// </summary> public bool CanExtend(object extendee) { return true; } }}实现说明：
1、让ToolDescribe类实现System.ComponentModel.IExtenderProvider接口，并继承System.ComponentModel.Component类，同时用ProvidePropertyAttribute特性描述该类。实现IExtenderProvider接口就表明本类是一个【扩展程序提供程序】，MSDN有相关的示例：http://msdn.microsoft.com/zh-cn/library/ms229066(v=vs.80).aspx。那么到底是要给什么类扩展出什么属性呢，这是由ProvideProperty特性定义的，本类的目的是为【ToolStripItem】类扩展出一个叫【Describe】的属性，所以这样描述[ProvideProperty("Describe", typeof(ToolStripItem))]。继承Component则是为了让ToolDescribe像ToolTip那样能拖入到VS组件栏中，这样item的属性窗格中才会多出一个Describe属性来；
2、在ToolDescribe类中定义一个集合类容器，用于存储设置了功能描述的item及其描述文本。本例采用的是Dictionary<ToolStripItem, string>，显然Key代表item，Value代表item的描述文本；
3、定义一个属性，类型为Component，用来呈现item功能描述的控件，本例是Viewer。类型之所以为Component而不是Control，是考虑到Viewer要允许设置为状态栏标签（ToolStripStatusLabel）的，而ToolStripStatusLabel并不是Control，所以得把类型定得再“基类”一点，以加大Viewer的设置灵活性；
4、实现一个public string GetDescribe(ToolStripItem item)方法，作用是获取指定item的描述文本，这也是第2步中定义容器的原因，没有容器记录下各个item及其描述文本的话，这个方法将难以实现。注意该方法的命名必须是Get+ProvideProperty中定义的扩展属性名，即Describe，合起来就是GetDescribe。另外，对该方法加DefaultValue特性是必要的，不然当拖入ToolDescribe时，VS会对所有item进行扩展，不管有没有设置某个item的Describe，这点可以从InitializeComponent方法中看出来；
5、实现一个public void SetDescribe(ToolStripItem item, string value)方法，命名要求同上。该方法的作用显然是用来设置item的描述文本的。具体实现逻辑上，它主要要做两件事：①把item及其value存入集合；②注册item的相关事件。即当item发生了什么时要做什么事，本例当然是当item发生MouseEnter和MouseLeave时，要做一些事，所以得注册item的这俩事件。说到这里，其实可以理解显示item功能描述的核心实现仍然是基于对相关事件的注册，也就是说本质上，与前面提到的分别为各个item注册事件这种看起来原始且笨的方式是一样一样的，用了ToolDescribe也没有什么高大上的地方，只是没那么麻烦了而已。当然这里说的是应用层面，底层VS对IExtenderProvider程序做了些什么那自然是高大上的；
6、实现上述事件的处理方法，本例就是item_MouseEnter和item_MouseLeave，实现上没什么好说的。只是上面的代码重点在演示实现套路，所以没有做额外的性能优化处理，如果代码要应用在生产环境，则需对if (Viewer is ToolStripItem)这样的语句进行处理，例如可以在Viewer属性的setter中就记录下Viewer属于何种类型，然后就不必在每次事件触发时判断Viewer类型了；
7、最后是实现IExtenderProvider接口的唯一成员：public bool CanExtend(object extendee)方法。这方法纯粹是供VS用的，方法的逻辑是，当你在VS中点击某个控件时，extendee就是该控件，返回true则在该控件的属性窗格中添加扩展属性，否则不添加。本例是直接返回true，那会不会造成点击任意控件都会多出Describe属性呢，答案是不会，因为ProvideProperty特性已经首先限定了只扩展ToolStripItem类。那该方法在什么情况下需要加逻辑呢，举例，要为Button和TextBox扩展属性，自然ProvideProperty限定为Control较合适，但这样一来，不属于Button和TextBox的其它控件也被扩展了，为了不扩展它们，就需要在CanExtend方法中加逻辑return extendee is Button || extendee is TextBox，等于一个控件是否会被扩展，取决于两个地方，一是ProvideProperty，二是CanExtend，前者是第一关，后者是第二关;
OK，套路就是这样，看看成果：
1、拖入一个ToolDescribe组件，并设置其Viewer为状态栏标签：
2、设置item的Describe属性，见图3；
3、跑起来看看：
话说回来，对于这种效果，路过高手如果有比添加扩展属性更好的方案还望不吝赐教。
下面附赠一枚正式的ToolDescribe，这个比上述Demo强在，可以为ToolStripItem、Control、MenuItem添加扩展属性，并对性能优化做了处理，可用于生产环境。同时可以看出ProvideProperty特性可以叠加使用，达到为不同控件添加不同扩展属性的目的，话说之所以不写成为Component扩展Describe属性，是因为MenuItem只有鼠标移进事件（Select），没有移出事件，要想达到指向没有设置Describe的MenuItem时，Viewer.Text清空，只有为所有MenuItem扩展，这也是没有为GetDescribeOfMenuItem加DefaultValue特性的原因~不知道看官能不能明白我在说什么，呵呵。上代码：
using System;using System.Collections.Generic;using System.ComponentModel;using System.Windows.Forms;namespace AhDung.WinForm.Controls{ /// <summary> /// 为菜单项或控件提供功能描述扩展属性 /// </summary> /// <remarks> /// Author:AhDung /// Update:201412161356，初版 /// </remarks> [Description("为菜单项或控件提供功能描述扩展属性")] [ProvideProperty("DescribeOfToolStripItem", typeof(ToolStripItem))] [ProvideProperty("DescribeOfControl", typeof(Control))] [ProvideProperty("DescribeOfMenuItem", typeof(MenuItem))] public class ToolDescribe : Component, IExtenderProvider { /// <summary> /// 存储所服务的组件及其描述 /// </summary> readonly Dictionary<Component, string> dic; Component viewer; bool viewerIsToolStripItem, viewerIsStatusBarPanel, viewerIsControl; ToolStripItem viewerAsToolStripItem; StatusBarPanel viewerAsStatusBarPanel; Control viewerAsControl; /// <summary> /// 获取或设置用于显示功能描述的控件 /// </summary> [DefaultValue(null), Description("设置用于显示功能描述的控件")] public Component Viewer { get { return viewer; } set { if (viewer == value) { return; } viewer = value; viewerIsToolStripItem = false; viewerIsStatusBarPanel = false; viewerIsControl = false; if (viewer is ToolStripItem) { viewerIsToolStripItem = true; viewerAsToolStripItem = viewer as ToolStripItem; } else if (viewer is StatusBarPanel) { viewerIsStatusBarPanel = true; viewerAsStatusBarPanel = viewer as StatusBarPanel; } else if (viewer is Control) { viewerIsControl = true; viewerAsControl = viewer as Control; } } } /// <summary> /// 创建一个ToolDescribe类 /// </summary> public ToolDescribe() { dic = new Dictionary<Component, string>(); } /// <summary> /// 获取ToolStripItem描述 /// </summary> [DefaultValue(null), Description("设置菜单项的功能描述")] public string GetDescribeOfToolStripItem(ToolStripItem item) { return GetDescribe(item); } /// <summary> /// 获取Control描述 /// </summary> [DefaultValue(null), Description("设置控件的功能描述")] public string GetDescribeOfControl(Control item) { return GetDescribe(item); } /// <summary> /// 获取MenuItem描述 /// </summary> [Description("设置菜单项的功能描述")] public string GetDescribeOfMenuItem(MenuItem item) { return GetDescribe(item); } //获取组件描述（私有） private string GetDescribe(Component item) { string value; dic.TryGetValue(item, out value); return value; } /// <summary> /// 设置ToolStripItem描述 /// </summary> public void SetDescribeOfToolStripItem(ToolStripItem item, string value) { if (item == null) { return; } if (string.IsNullOrEmpty(value) || value.Trim().Length == 0) { dic.Remove(item); item.MouseEnter -= item_MouseEnter; item.MouseLeave -= item_MouseLeave; } else { if (!dic.ContainsKey(item)) { item.MouseEnter += item_MouseEnter; item.MouseLeave += item_MouseLeave; } dic[item] = value; } } /// <summary> /// 设置Control描述 /// </summary> public void SetDescribeOfControl(Control item, string value) { if (item == null) { return; } if (string.IsNullOrEmpty(value) || value.Trim().Length == 0) { dic.Remove(item); item.MouseEnter -= item_MouseEnter; item.MouseLeave -= item_MouseLeave; } else { if (!dic.ContainsKey(item)) { item.MouseEnter += item_MouseEnter; item.MouseLeave += item_MouseLeave; } dic[item] = value; } } /// <summary> /// 设置MenuItem描述 /// </summary> public void SetDescribeOfMenuItem(MenuItem item, string value) { if (item == null) { return; } if (!dic.ContainsKey(item)) { item.Select += item_MouseEnter; } dic[item] = value; } //组件鼠标指向事件 private void item_MouseEnter(object sender, EventArgs e) { this.SetViewerText(dic[sender as Component]); } //组件鼠标移开事件 private void item_MouseLeave(object sender, EventArgs e) { this.SetViewerText(string.Empty); } /// <summary> /// 设置Viewer的Text值 /// </summary> private void SetViewerText(string s) { if (viewerIsToolStripItem) { viewerAsToolStripItem.Text = s; } else if (viewerIsStatusBarPanel) { viewerAsStatusBarPanel.Text = s; } else if (viewerIsControl) { viewerAsControl.Text = s; } } //实现IExtenderProvider成员 [EditorBrowsable(EditorBrowsableState.Never)] public bool CanExtend(object extendee) { return !(extendee is Form); } }}
- 文毕-
【C#】使用IExtenderProvider为控件添加扩展属性，像ToolTip那样