<think>我们被要求的任务是:提供一个WinForm自定义加载控件的完整代码示例。根据引用内容,自定义控件通常通过继承现有控件类(如Control或UserControl)来实现。我们将创建一个简单的自定义控件,展示如何设计、实现和使用它。
步骤:
1. 创建自定义控件类:从UserControl继承(或Control),添加一些子控件和功能。
2. 实现控件的属性和方法。
3. 在窗体中使用这个自定义控件。
示例:创建一个带有加载动画的自定义控件(一个旋转的圆圈),模拟加载过程。
由于是完整示例,我们将创建两个部分:
- 自定义控件类:LoadingSpinner
- 使用该控件的窗体:MainForm
注意:我们将使用.NET Framework 4.0,以确保与引用[2]中的控件库兼容。
具体实现:
LoadingSpinner控件:使用一个Timer控件(System.Windows.Forms.Timer)来触发动画,并在Paint事件中绘制一个旋转的圆圈。
我们添加一个属性IsLoading来控制动画的启动和停止。
代码结构:
1. 创建自定义控件项目或在现有WinForm项目中添加一个自定义控件。
2. 编写控件代码。
3. 在窗体中添加该控件并设置属性。
由于我们无法实际执行代码,但需要给出完整示例,因此提供完整的C#代码。
注意:确保在代码中添加必要的注释。
以下是代码示例:
首先,创建自定义控件类:
</think>
### WinForm 自定义加载控件完整代码示例
以下是基于.NET Framework的WinForm自定义加载控件的完整实现示例,展示了如何创建一个带有旋转动画的加载控件。这里采用两种实现方式:
#### 方案1:使用标准控件组合实现
```csharp
using System;
using System.Drawing;
using System.Windows.Forms;
namespace CustomLoadingControl
{
// 自定义加载控件类
public class LoadingSpinner : UserControl
{
// 控件组件
private PictureBox _pictureBox;
private Timer _timer;
private int _currentImageIndex = 0;
private readonly Image[] _loadingFrames;
// 加载状态属性
public bool IsLoading
{
get => _timer.Enabled;
set
{
_timer.Enabled = value;
Visible = value;
}
}
// 控件初始化
public LoadingSpinner()
{
// 初始化动画帧(实际项目中应使用真实图片)
_loadingFrames = new Image[8];
for (int i = 0; i < 8; i++)
{
_loadingFrames[i] = CreateFrameImage(i);
}
// 配置控件
Size = new Size(100, 100);
BackColor = Color.Transparent;
// 创建图片显示控件
_pictureBox = new PictureBox
{
SizeMode = PictureBoxSizeMode.StretchImage,
Size = Size,
Image = _loadingFrames[0]
};
Controls.Add(_pictureBox);
// 动画定时器
_timer = new Timer { Interval = 100 };
_timer.Tick += (s, e) => {
_currentImageIndex = (_currentImageIndex + 1) % _loadingFrames.Length;
_pictureBox.Image = _loadingFrames[_currentImageIndex];
};
}
// 创建动画帧(简化示例)
private Bitmap CreateFrameImage(int frame)
{
var bmp = new Bitmap(100, 100);
using (Graphics g = Graphics.FromImage(bmp))
using (Pen pen = new Pen(Color.Blue, 10))
{
g.Clear(Color.Transparent);
int startAngle = frame * 45;
g.DrawArc(pen, 10, 10, 80, 80, startAngle, 90);
}
return bmp;
}
}
}
```
#### 方案2:纯GDI+绘制实现(高性能)
```csharp
using System;
using System.Drawing;
using System.Windows.Forms;
namespace CustomLoadingControl
{
public class AdvancedLoadingSpinner : Control
{
private Timer _timer;
private float _angle = 0;
private Color _spinnerColor = Color.DodgerBlue;
// 加载状态控制
public bool IsLoading
{
get => _timer.Enabled;
set
{
_timer.Enabled = value;
Visible = value;
}
}
// 旋转速度属性(毫秒)
public int Speed
{
get => _timer.Interval;
set => _timer.Interval = Math.Max(10, value);
}
public AdvancedLoadingSpinner()
{
SetStyle(ControlStyles.SupportsTransparentBackColor, true);
BackColor = Color.Transparent;
DoubleBuffered = true;
Size = new Size(80, 80);
_timer = new Timer { Interval = 50 };
_timer.Tick += (s, e) => {
_angle = (_angle + 10) % 360;
Invalidate();
};
}
// 自定义绘制
protected override void OnPaint(PaintEventArgs e)
{
base.OnPaint(e);
using (var pen = new Pen(_spinnerColor, 8))
using (var brush = new SolidBrush(Color.FromArgb(50, _spinnerColor)))
{
e.Graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
// 绘制旋转弧线
e.Graphics.DrawArc(pen, 10, 10, Width-20, Height-20, _angle, 270);
// 可选:添加中心文本
if (!string.IsNullOrEmpty(Text))
{
var textFormat = new StringFormat {
Alignment = StringAlignment.Center,
LineAlignment = StringAlignment.Center
};
e.Graphics.DrawString(Text, Font, Brushes.Black,
new RectangleF(0,0,Width,Height), textFormat);
}
}
}
}
}
```
#### 使用示例
```csharp
// 在窗体中添加控件
public partial class MainForm : Form
{
private readonly LoadingSpinner _spinner = new LoadingSpinner();
public MainForm()
{
InitializeComponent();
// 配置加载控件
_spinner.Location = new Point((Width - _spinner.Width)/2, (Height - _spinner.Height)/2);
Controls.Add(_spinner);
// 开始模拟加载
Button loadButton = new Button { Text = "开始加载", Location = new Point(20, 20) };
loadButton.Click += (s, e) => {
_spinner.IsLoading = true;
// 模拟耗时操作
Task.Run(() => {
Thread.Sleep(2000);
Invoke((Action)(() => _spinner.IsLoading = false));
});
};
Controls.Add(loadButton);
}
}
```
#### 关键实现说明
1. **控件继承结构**:
- 方案1继承 `UserControl` 实现图片动画
- 方案2继承 `Control` 使用GDI+高性能绘制
2. **核心功能**:
- 通过 `Timer` 驱动动画刷新
- 使用 `Invalidate()` 触发重绘
- 透明背景支持(`SetStyle`配置)
3. **扩展能力**:
- 可添加自定义属性(速度/颜色/文本)
- 支持数据绑定和样式模板(参考引用[4])
- 兼容触屏操作(参考引用[2])
4. **部署使用**:
```markdown
1. 将类文件添加到项目
2. 从工具箱拖拽到窗体
3. 通过IsLoading属性控制显示
```
自定义加载控件能显著提升用户体验,特别适用于数据加载、后台任务处理等场景[^5]。
### 注意事项
1. 动态资源需手动释放:在`Dispose`中释放`Timer`和`Image`资源
2. 高DPI支持:添加`Application.SetHighDpiMode(HighDpiMode.SystemAware)`
3. 性能优化:复杂动画建议使用双缓冲(`DoubleBuffered=true`)