C# Winform常见的Editor及其它经验

时间:2023-03-09 14:51:58
C# Winform常见的Editor及其它经验

1、新建一个自定义Editor,继承自.NET自带的Editor,override某些方法,再附加到属性中:

public class MyCollectionEditor : CollectionEditor
{
public MyCollectionEditor(Type type) : base(type)
{
}
protected override void ShowHelp()
{
MessageBox.Show("别点了,点了也没用。");
}
}
[Editor(typeof(MyCollectionEditor), typeof(UITypeEditor))]
public List<B> Bs2 { get; set; }

上图就在列表编辑框中重定义了点击“Help”时的操作。一般都是这么用的。

2、常见Editor

1)ArrayEditor,继承自CollectionEditor

2)BinaryEditor

3)CollectionEditor

4)DateTimeEditor

5)MultilineStringEditor

6)BitmapEditor,继承自ImageEditor

7)ColorEditor

8)ContentAlignmentEditor

9)CursorEditor

10)FontEditor

11)FontNameEditor

12)IconEditor

13)ImageEditor

14)MetafileEditor

15)UITypeEditor,所有这些的基类,他们能继承自它,我们怎么不行?

16)QueuePathEditor

17)DataControlReferenceCollectionEditor,继承自CollectionEditor

18)AppSettingsExpressionEditor,继承自ExpressionEditor

19)CollectionEditorBase,继承自CollectionEditor

20)ConnectionStringEditor

21)ConnectionStringsExpressionEditor,继承自ExpressionEditor

22)DataBindingCollectionEditor

23)ExpressionEditor

24)ExpressionCollectionEditor

25)ImageUrlEditor,继承自UrlEditor

26)MailFileEditor,继承自UrlEditor

27)MdbDataFileEditor,继承自UrlEditor

28)ResourceExpressionEditor,继承自ExpressionEditor

29)RouteUrlEditor,继承自ExpressionEditor

30)RouteValueExpressionEditor,继承自ExpressionEditor

31)ServiceReferenceCollectionEditor,继承自CollectionEditorBase

32)UpdatePanelTriggerCollectionEditor,继承自CollectionEditorBase

33)UrlEditor

34)UserControlFileEditor,继承自UrlEditor

35)AnchorEditor

36)BorderSidesEditor

37)DockEditor

38)FileNameEditor

39)FolderNameEditor

40)FormatStringEditor

41)ImageListImageEditor

42)ShortcutKeysEditor

43)BindingUIEditor

44)TypeBrowserEditor

还有部分Web命名空间下的没有记录,寻找方法,在对象浏览器中,搜索Editor,找出以Editor结尾,并继承自UITypeEditor的类即可。

3、可展开项的示例

[TypeConverter(typeof(ExpandableObjectConverter))]
public class B
{
public int Name1 { get; set; }
public int Name2 { get; set; }
public override string ToString()
{
return Name1 + "-" + Name2;
}
}
public class A
{
public A()
{
if (Bs == null)
{
Bs = new B();
}
}
public B Bs { get; set; }
}

4、下拉框的示例

public class XXXConverter : StringConverter
{
public override StandardValuesCollection GetStandardValues(ITypeDescriptorContext context)
{
return new StandardValuesCollection(StringArray);
}
public override bool GetStandardValuesSupported(ITypeDescriptorContext context)
{
return true;
}
public override bool GetStandardValuesExclusive(ITypeDescriptorContext context)
{
return true;
}
public static string[] StringArray = new[] { "AAA", "BBB" };
}
[TypeConverter(typeof(XXXConverter))]
public string Name2 { get; set; }

5、有效性验证示例

public class OneTo32Converter : Int32Converter
{
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
var result = (int)base.ConvertFrom(context, culture, value);
if (result < || result > )
{
throw new Exception("输入值要在1至32之间。");
}
return result;
}
}
[TypeConverter(typeof(OneTo32Converter))]
public int Name1 { get; set; }

6、数组自定义显示及去除展开对话框示例

public class XXXArrayConverter : ArrayConverter
{
public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
{
return "sssss";
}
}
[TypeConverter(typeof(XXXArrayConverter)), Editor(typeof(UITypeEditor), typeof(UITypeEditor))]
public B[] Bs { get; set; }

7、Converter及Editor总结

如果附在uint类型的属性上,则:

Converter是用于该属性的类型uint与用于显示的类型string之间的转换;

ConvertFrom是string转换成uint;

ConvertTo是uint转换成string;

如果使用DateTimeEditor,则:

该Editor是用于uint与DateTime之间的转换;

而DateTimeEditor只会处理DateTime与DateTime之间的转换,所以要在EditValue方法中完成uint与DateTime的转换。

public class MyDateTimeEditor : DateTimeEditor
{
public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)
{
var result = (DateTime) base.EditValue(context, provider, new DateTime(, , ).AddSeconds((uint) value));
return (uint) ((result - new DateTime(, , )).TotalSeconds);
}
}
[TypeConverter(typeof(UInt32Converter)), Editor(typeof(MyDateTimeEditor), typeof(UITypeEditor))]
public uint C { get; set; }

Converter用于处理输入值时的行为,常用于有效性验证、格式转换等,而Editor用于处理下拉或打开新窗口时的行为。它们可以在同一个属性上共存。

8、自定义窗体示例

public class MyUITypeEditor : UITypeEditor
{
public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)
{
var picker = new Form1((uint) value);
if (picker.ShowDialog() == DialogResult.OK)
{
return picker.Seconds;
}
return value;
} public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext context)
{
return UITypeEditorEditStyle.Modal;
}
}

9、可编辑复合对象

public class A
{
public A()
{
if (EndPoint == null)
{
EndPoint = new PGIPEndPoint
{
IPAddress = "255.255.255.255",
Port =
};
}
}
[TypeConverter(typeof(IPEndPointConverter))]
public PGIPEndPoint EndPoint { get; set; }
}
public class IPEndPointConverter : ExpandableObjectConverter
{
public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
{
return true;
}
public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
{
return true;
}
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
var result = ((string)value).Split(':');
var ip = IPAddress.Parse(result[]);
var port = Convert.ToInt32(result[]);
if (port < || port > )
{
throw new Exception(string.Format("{0}要在0至65535之间。", port));
}
return new PGIPEndPoint
{
IPAddress = ip.ToString(),
Port = port
};
}
public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
{
var result = (PGIPEndPoint)value;
return string.Format("{0}:{1}", result.IPAddress, result.Port);
}
}
public class PGIPEndPoint
{
[TypeConverter(typeof(IPConverter))]
public string IPAddress { get; set; }
[TypeConverter(typeof(ZeroTo65535Converter))]
public int Port { get; set; }
} public class ZeroTo65535Converter : Int32Converter
{
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
var result = Convert.ToInt32(value);
if (result < || result > )
{
throw new Exception(string.Format("{0}要在0至65535之间。", result));
}
return result;
}
} public class IPConverter : StringConverter
{
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
return (IPAddress.Parse((string)value)).ToString();
}
}

10、属性的显示顺序

把PropertyGrid控件的PropertySort设置为NoSort可使属性以其被截取時的顺序显示。

11、去除工具栏

把ToolBarVisible设置为False。