創建C#自定義控件：旋轉按鈕
作者：lyl
本文將介紹如何創建一個旋轉按鈕（Rotary Button），這種按鈕在用戶點擊或拖動時能夠旋轉，并觸發特定事件。我們將使用Windows Forms來實現這一控件。
在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);
}
}
}六、總結
通過本文，我們了解了如何創建一個基本的旋轉按鈕自定義控件。你可以根據實際需求進一步擴展這個控件的功能，例如添加更多的外觀定制選項，處理不同的鼠標事件，或者集成動畫效果。自定義控件在復雜用戶界面和交互式應用程序中非常有用，希望這篇文章對你有所幫助。
責任編輯：趙寧寧
來源：
后端Q
