创建C#自定义控件：旋转按钮-51CTO.COM

在C#中，自定义控件可以帮助开发者根据特定需求扩展标准控件的功能。本文将介绍如何创建一个旋转按钮（Rotary Button），这种按钮在用户点击或拖动时能够旋转，并触发特定事件。我们将使用Windows Forms来实现这一控件。

一、环境准备

Visual Studio 2019或更高版本
.NET Framework 4.7.2或更高版本

二、创建自定义控件项目

打开Visual Studio，创建一个新的“Windows Forms 控件库”项目，命名为 RotaryButtonLibrary。
在项目中添加一个新的“用户控件”，命名为 RotaryButton.cs。

三、设计旋转按钮

1. 修改RotaryButton.cs的设计

首先，我们需要让我们的控件继承自UserControl，并在设计视图中进行一些基本设置。

using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

namespace RotaryButtonLibrary
{
    public partial class RotaryButton : UserControl
    {
        private Timer timer;
        private float angle = 0;
        private bool isRotating = false;

        public RotaryButton()
        {
            InitializeComponent();
            this.DoubleBuffered = true; // 防止重画闪烁
            this.Size = new Size(100, 100); // 默认大小
            this.BackColor = Color.LightGray; // 默认背景色
            this.Cursor = Cursors.Hand; // 鼠标指针样式

            // 初始化计时器
            timer = new Timer();
            timer.Interval = 10; // 每10ms触发一次
            timer.Tick += Timer_Tick;
        }

        private void Timer_Tick(object sender, EventArgs e)
        {
            if (isRotating)
            {
                angle += 5; // 每次增加5度
                if (angle >= 360) angle = 0;
                this.Invalidate(); // 触发重绘
            }
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);
            Graphics g = pe.Graphics;
            g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

            // 绘制旋转后的按钮外观，这里简单用一个矩形表示
            g.TranslateTransform(this.Width / 2, this.Height / 2); // 将旋转中心点移动到控件中心
            g.RotateTransform(angle); // 按指定角度旋转
            g.FillRectangle(Brushes.Blue, -this.Width / 2, -this.Height / 2, this.Width, this.Height); // 绘制按钮
            g.ResetTransform(); // 重置变换
        }

        protected override void OnMouseDown(MouseEventArgs e)
        {
            base.OnMouseDown(e);
            isRotating = true;
            timer.Start();
        }

        protected override void OnMouseUp(MouseEventArgs e)
        {
            base.OnMouseUp(e);
            isRotating = false;
            timer.Stop();
        }
    }
}

2. 添加控件到工具箱

构建项目后，RotaryButton控件会自动出现在工具箱中。如果没有，可以右键工具箱，选择“选择项...”，然后在“浏览”中添加生成的DLL文件。

3. 使用旋转按钮

创建一个新的Windows Forms应用程序，从工具箱中拖出RotaryButton控件并放到窗体上。运行程序，你会看到点击按钮时，按钮开始旋转，松开鼠标按钮时，旋转停止。

四、扩展功能

为了让旋转按钮更加实用，我们可以添加一些额外属性和事件。例如，可以提供一个RotationSpeed属性来控制旋转速度，或者提供一个RotationCompleted事件来在旋转一圈完成时触发。

1. 添加RotationSpeed属性

private int rotationSpeed = 5; // 默认旋转速度

[Browsable(true), EditorBrowsable(EditorBrowsableState.Always)]
public int RotationSpeed
{
    get { return rotationSpeed; }
    set { rotationSpeed = value; }
}

修改Timer_Tick方法以使用rotationSpeed：

private void Timer_Tick(object sender, EventArgs e)
{
    if (isRotating)
    {
        angle += rotationSpeed; // 使用RotationSpeed
        if (angle >= 360) 
        {
            angle = 0;
            OnRotationCompleted(EventArgs.Empty); // 触发旋转完成事件
        }
        this.Invalidate(); // 触发重绘
    }
}

2. 添加RotationCompleted事件

public event EventHandler RotationCompleted;

protected virtual void OnRotationCompleted(EventArgs e)
{
    RotationCompleted?.Invoke(this, e);
}

五、完整代码示例

以下是完整的RotaryButton.cs代码：

using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

namespace RotaryButtonLibrary
{
    public partial class RotaryButton : UserControl
    {
        private Timer timer;
        private float angle = 0;
        private bool isRotating = false;
        private int rotationSpeed = 5; // 默认旋转速度

        public RotaryButton()
        {
            InitializeComponent();
            this.DoubleBuffered = true; // 防止重画闪烁
            this.Size = new Size(100, 100); // 默认大小
            this.BackColor = Color.LightGray; // 默认背景色
            this.Cursor = Cursors.Hand; // 鼠标指针样式

            // 初始化计时器
            timer = new Timer();
            timer.Interval = 10; // 每10ms触发一次
            timer.Tick += Timer_Tick;
        }

        [Browsable(true), EditorBrowsable(EditorBrowsableState.Always)]
        public int RotationSpeed
        {
            get { return rotationSpeed; }
            set { rotationSpeed = value; }
        }

        private void Timer_Tick(object sender, EventArgs e)
        {
            if (isRotating)
            {
                angle += rotationSpeed; // 使用RotationSpeed
                if (angle >= 360) 
                {
                    angle = 0;
                    OnRotationCompleted(EventArgs.Empty); // 触发旋转完成事件
                }
                this.Invalidate(); // 触发重绘
            }
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);
            Graphics g = pe.Graphics;
            g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

            // 绘制旋转后的按钮外观，这里简单用一个矩形表示
            g.TranslateTransform(this.Width / 2, this.Height / 2); // 将旋转中心点移动到控件中心
            g.RotateTransform(angle); // 按指定角度旋转
            g.FillRectangle(Brushes.Blue, -this.Width / 2, -this.Height / 2, this.Width, this.Height); // 绘制按钮
            g.ResetTransform(); // 重置变换
        }

        protected override void OnMouseDown(MouseEventArgs e)
        {
            base.OnMouseDown(e);
            isRotating = true;
            timer.Start();
        }

        protected override void OnMouseUp(MouseEventArgs e)
        {
            base.OnMouseUp(e);
            isRotating = false;
            timer.Stop();
        }

        public event EventHandler RotationCompleted;

        protected virtual void OnRotationCompleted(EventArgs e)
        {
            RotationCompleted?.Invoke(this, e);
        }
    }
}

六、总结

通过本文，我们了解了如何创建一个基本的旋转按钮自定义控件。你可以根据实际需求进一步扩展这个控件的功能，例如添加更多的外观定制选项，处理不同的鼠标事件，或者集成动画效果。自定义控件在复杂用户界面和交互式应用程序中非常有用，希望这篇文章对你有所帮助。