c#自定义控件属性面板及选择资源设置

时间:2023-01-10 16:35:43

博客转移到 http://jacean.github.io/ 继续分享编程经验

因为要做流体布局,但两个控件没办法组合,就做自定义控件。这个控件需要一个text设置文本,一个pic设置图片显示,图片通过选择获取,在属性面板里能够修改。

添加用户控件之后就可以自己随意设置控件内容了,这里说下关于属性的一些设置。

  1. 自定义控件显示在工具箱的开关:
    将true改为false就可以不显示了。
    [ToolboxItem(true)]
    public partial class UserControl1 : UserControl
  2. 自定义控件在工具箱中的图标显示:
    可以使用已有控件的图标,
     [ToolboxBitmap(typeof(System.Windows.Forms.PictureBox))]
    public partial class UserControl1 : UserControl

    如果不想用系统的图标,要使用自己的图标,可以这样(这部分未测试,源于参考文章)

     [ToolboxBitmap(typeof(MyPanel), "WindowsApplication1.Images.MyPanel.bmp")]
    public class MyPanel : UserControl

    不过,一定要注意路径,WindowsApplication1.Images.MyPanel.bmp表示,解决方案是WindowsApplication1,目录是Images,文件名是MyPanel.bmp,同时,这个图片必须是“嵌入的资源”(点击文件,右键,属性,有一个文件属性,其中,在生成操作中,可以选择"嵌入的资源")

  3. 自定义控件在属性面板上的显示开关:
     [Browsable(true)]
    [Description("属性描述"), Category("属性类别"), DefaultValue("属性默认值,重置时使用")]
    public override string Text
    {
    get { return label1.Text; }
    set { label1.Text = value; }
    }

    category设定的是属性在属性面板上显示的类别,当使用了类别时,组件属性和事件可以按逻辑分组显示在属性浏览器中。Category("Appearance")就可以把属性从杂项转移到外观。
    (摘抄自参考文章)用于设置默认的值,对于string,bool,int,可以直接写出来,如[DefaultValue(10)],这是可以的,不过,不是这三种类型的话,就比较麻烦,一定要先转化为string才能设置成功。如上面的DarkGray,这是系统定义的颜色,这还是比较好处理的。不过,如果是一些自定义的颜色,如颜色是128,0,128,你应该将128转为16进制,写成0x800080,前缀0x是一定要加的。最后就这样[DefaultValue(typeof(Color), "0x800080")]
    还有一种[DefaultValue(typeof(Color), "0, 70, 213")]
    如果是字体的话需要[DefaultValue(typeof(Font), "宋体, 9pt")]
    这两种特殊情况三种方法本人均未测试。

  4. 自定义控件属性选择资源:
    如果自定义的属性不是文本等输入,是图片之类的就需要类似于picturebox的资源选择了,所以在设置属性的时候使用文件类型来定义,如选择图片的例下
     [Browsable(true)]
    [Description("设置控件图片"), Category("setPic"), DefaultValue(" ")]
    public Bitmap setPic
    {
    get { return (Bitmap)this.pictureBox1.Image; }
    set
    {
    this.pictureBox1.Image = value;
    }
    }

    这样的话就会在属性面板的设置中出现选择资源的对话框来选择。

  5. 自定义控件属性选择下拉列表:

    在定义属性的时候需要先设置好枚举值,通过枚举来定义属性,如例下

     1 public enum indexEnum
    2 {
    3 a,
    4 b,
    5 c
    6 }
    7 public indexEnum index;
    8 [Browsable(true)]
    9 [Description("设置index"), Category("Index"), DefaultValue("属性默认值")]
    10 public indexEnum Index
    11 {
    12 get { return index; }
    13 set { index = value; }
    14 }

附:

参考文章:常用Design属性 【C#】妈妈再也不用担心自定义控件如何给特殊类型的属性添加默认值了,附自定义GroupBox一枚