首页 > 代码库 > 【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那样