<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`）