Msdn上对DesignerActionList和DesignerAction的介绍为:DesignerAction 功能允许组件和控件显示 区分大小写的信息和命令。DesignerAction 功能可被视为设计器谓词的替代项,因为 DesignerActionItem 可显示在智能标记面板中,也可显示在与组件或控件相关联的快捷菜单中。对于要 在自定义组件和控件中添加智能标记支持的开发人员,DesignerActionList 类表示主交互点。 DesignerActionList 是一个基类,组件开发人员可从中派生类来填充智能标记面板。智能标记面板将智 能标记表示为类似于菜单的用户界面 (UI)。
DesignerActionItem为智能面板上的一项,我们要向智能面板上添加一项,只要实例化一个 DesignerActionItem,DesignerActionList类里有个可以被override的方法GetSortedActionItems()返回 类型为DesignerActionItemCollection,它实际上就是返回智能面板上项的集合,我们只要把 DesignerActionItem实例添加到GetSortedActionItems()的返回值即可。
在.net中DesignerActionMethodItem、DesignerActionPropertyItem、DesignerActionTextItem、 DesignerActionHeaderItem继承于DesignerActionItem,它们的成员大部分都是相同的, DesignerActionMethodItem主要在智能面板上生成一个方法项,点击这个项会去执行相应的方法; DesignerActionPropertyItem则把Component的属性显示在智能面板上,用户可以在职能面板上对 Component的属性进行设置和修改;DesignerActionTextItem是在智能面板上生成一个文本项;而 DesignerActionHeaderItem是继承于DesignerActionTextItem,但它多了分组的功能。
代码演示如下:
using System.Collections.Generic;
using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Text;
using System.Reflection;
using System.Windows.Forms;
namespace ClassLibrary1
{
[Designer(typeof(CustomerDesigner), typeof(IDesigner))]
public class Customer : Component
{
private string _id;
private Sex _sex;
private string _address;
public string Id
{
get { return _id; }
set { _id = value; }
}
public Sex Sex
{
get { return _sex; }
set { _sex = value; }
}
public string Address
{
get { return _address; }
set { _address = value; }
}
}
public enum Sex
{
男 = 0,
女 = 1
}
public class CustomerDesigner : ComponentDesigner
{
private DesignerActionListCollection actionLists;
// 只有get,没有set。
public override DesignerActionListCollection ActionLists
{
get
{
if (null == actionLists)
{
actionLists = new DesignerActionListCollection();
actionLists.Add(
new CustomerActionList(this.Component));
}
return actionLists;
}
}
private void OnClick2(object sender, EventArgs e)
{
MessageBox.Show("Click2.");
}
// 添加了一个谓词(在右键菜单中出现)。
// 如果重写了DesignerActionList,则此谓词不会加在智能标记中。
public CustomerDesigner()
{
DesignerVerb verb2 = new DesignerVerb("Click2", new EventHandler (OnClick2));
this.Verbs.Add(verb2);
}
}
// DesignerActionList:智能标记面板上的项列表
public class CustomerActionList : DesignerActionList
{
private Customer customer;
public CustomerActionList(IComponent component) : base(component)
{
this.customer = component as Customer;
}
/**//*
TypeDescriptor —— 通过类型来获取Component的Attribute、Property、Event。
*/
public string Id // 注1
{
get
{ return customer.Id; }
set
{ TypeDescriptor.GetProperties(typeof(Customer))["Id"]
.SetValue(customer, value);
}
}
public Sex Sex
{
get
{ return customer.Sex; }
set
{ TypeDescriptor.GetProperties(typeof(Customer))["Sex"]
.SetValue(customer, value); }
}
public void OnClick1()
{
MessageBox.Show("Click1.");
}
public override DesignerActionItemCollection GetSortedActionItems()
{
DesignerActionItemCollection items = new DesignerActionItemCollection();
// HeaderItem
// 创建智能面板上项的分类。
DesignerActionHeaderItem hInfo = new DesignerActionHeaderItem ("Customer's Info", "Info");
items.Add(hInfo);
DesignerActionHeaderItem hAction = new DesignerActionHeaderItem ("Customer's Action", "Action");
items.Add(hAction);
DesignerActionHeaderItem hDescription = new DesignerActionHeaderItem ("Description");
items.Add(hDescription);
// PropertyItem
// DesignerActionPropertyItem("Id" —— 注1位置的Property
// , "Id" —— 显示在智能面板上的名称
// , "Info" —— 智能面板上的分类
// ,"Customer's id") —— 补充说明文本
items.Add(new DesignerActionPropertyItem("Id", "Id", "Info", "Customer's id"));
items.Add(new DesignerActionPropertyItem("Sex", "Sex", "Info", "Customer's sex"));
// 添加一个MethodItem。
// 此MethodItem会默认向Component的右键菜单中添加一项。
items.Add(new DesignerActionMethodItem(this, "OnClick1", "Click1", "Action", true));
// 添加一个TextItem.
items.Add(new DesignerActionTextItem("http://mapserver.cnblogs.com", "Description"));
return items;
}
}
}