解析C#自定义控件的制作与使用实例的详解

什么是自定义控件

自定义控件是指基于原有控件进行继承、扩展、封装的新型控件。自定义控件可以满足细分领域的需求，提高代码复用性和可维护性，也可以大大提高开发效率。

制作自定义控件的步骤

1. 新建Windows Forms控制台应用程序。

2. 选择项目，右键菜单中“添加”→ “用户控件” → “Inherited Control”添加控件。

3. 为自定义控件编写代码。

   • 为自定义控件添加属性：在代码注释中加入DescriptionAttribute描述控件时，将会直接呈现在属性面板中。
   • 为自定义控件添加事件：通过event关键字可以声明事件，使用委托定义事件的方法，最后触发这个事件。

4. 调试完毕后，在解决方案生成控件DLL。

5. 在需要使用的表单上引用DLL文件，即可使用自定义控件。

示例说明

示例一： 显示自定义控件的文字

在自定义控件中添加一个属性：CustomText，用以设置该控件显示的文本。并在控件的Paint事件中设置显示文本的大小、颜色等。

[Browsable(true), Description("Get or set the display string of this control."), Category("Appearance")]
public string CustomText { get; set; } = "Custom Control";

protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);
    if (string.IsNullOrWhiteSpace(CustomText))
    {
        return;
    }

    using (var brush = new SolidBrush(ForeColor))
    {
        var textSize = e.Graphics.MeasureString(CustomText, Font);
        var textX = (Width - textSize.Width) / 2;
        var textY = (Height - textSize.Height) / 2;

        e.Graphics.DrawString(CustomText, Font, brush, textX, textY);
    }
}

示例二：自定义控件的简单动画效果

在自定义控件中添加一个属性：Picture，用以设置该控件显示的图片。在控件的Timer事件中，每次将Picture的位置偏移，实现简单动画效果。

[Browsable(true), Description("Get or set the picture of this control."), Category("Appearance")]
public Image Picture { get; set; }

private readonly Timer _timer;

private int _offsetX = 0;
private int _offsetY = 0;

public CustomControl()
{
    InitializeComponent();

    _timer = new Timer();
    _timer.Interval = 10;
    _timer.Tick += Timer_Tick;
}

private void Timer_Tick(object sender, EventArgs e)
{
    _offsetX += 1;
    _offsetY += 1;

    if (_offsetX > 100)
    {
        _timer.Stop();
    }

    Invalidate();
}

protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);

    if (Picture == null)
    {
        return;
    }

    var x = _offsetX % Picture.Width;
    var y = _offsetY % Picture.Height;

    e.Graphics.DrawImage(Picture, x, y);
}

public void StartAnimation()
{
    _timer.Start();
}