【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 == )
{
//从集合中移除该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 == )
{
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 == )
{
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);
}
}
}
- 文毕-
最新文章
- 完整记录一则Oracle 11.2.0.4单实例打PSU补丁的过程
- Yii2.0 GridView 新增添加按钮
- 修改placeholder提示内容的颜色以及文本框输入文字内容的颜色
- CSS中控制换行的四种属性
- slf4j+log4j配置
- 动软代码生成与 EntityFramework 实体生成模板
- c#基础学习汇总----------base和this，new和virtual
- NAT（NAPT）地址转换过程
- avalonjs1.5 入门教程
- JAVA 程序发布引发性能抖动
- 最近跟mysql的自动shutdown干上了。。。
- 泡菜的使用pickle
- Leetcode#13. Roman to Integer（罗马数字转整数）
- spring InitializingBean和DisposableBean init-method 和destroy-method @PostConstruct @PreDestroy
- Python3-lamba表达式、zip函数
- Docker permission denied while trying to connect to the Docker daemon socket
- mysql知识汇总
- Django - 学习目录
- 在CentOS 7上安装Node.js的4种方法（yum安装和源码安装）
- CPU性能判断指标---上下文切换，运行队列和使用率