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

原文链接： https://www.cnblogs.com/jacean/p/4743920.html

因为要做流体布局，但两个控件没办法组合，就做自定义控件。这个控件需要一个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.自定义控件属性选择资源：

[Browsable(true)]
[Description("设置控件图片"), Category("setPic"), DefaultValue(" ")]
public Bitmap setPic
        {
            get { return (Bitmap)this.pictureBox1.Image; }
            set
            {
               this.pictureBox1.Image = value;
            }
        }

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

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

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

public enum indexEnum
        { 
            a,
            b,
            c
        }
public indexEnum index;
[Browsable(true)]
[Description("设置index"), Category("Index"), DefaultValue("属性默认值")]
public indexEnum Index
        {
            get { return index; }
            set { index = value; }
        }