简介本资源是一份基于C# WinForm开发的圆形进度条控件完整实现源码面向Windows桌面应用开发者尤其适合需要自定义UI组件的中初级.NET程序员。项目采用VS2019开发兼容.NET Framework 4.7.2及4.0内置HZH_Controls第三方UI库含nupkg与dll可直接集成至现有WinForm项目或作为自定义控件学习范例。压缩包共20个文件涵盖6个核心CS逻辑文件含Form1主窗体与设计器、3个配置文件app.config等、2个资源文件resx、1个解决方案sln及1个可执行exe结构完整便于理解WinForm控件生命周期、资源本地化与项目引用管理。资源包大小为16.81MB已有737人学习下载提供从设计到编译运行的全链路代码支持包含调试符号pdb与设置文件settings利于调试分析与二次定制。1. C# WinForm 圆形进度条例子源码不是画个圆就叫“圆形进度条”它得在工业上位机里扛住 500ms 刷新、不卡 UI、不崩线程你拖一个ProgressBar控件改Style ProgressBarStyle.Marquee再调CreateGraphics()手动画弧——这在调试窗里看着挺圆一放进真实 WinForm 上位机项目比如对接 PLC 读取温度、采集 Power Focus 6000 扭矩值、轮询串口设备状态立刻暴露三宗罪UI 线程被Invalidate()拖垮、GDI 绘图资源泄漏导致内存缓慢上涨、多控件并行刷新时弧度错位甚至消失。真正能落地的「C# WinForm 圆形进度条例子源码」核心不在“圆”而在可控刷新节奏 线程安全更新 无闪烁重绘 支持百分比/文本/颜色动态绑定。它不是玩具控件而是嵌入在WinForm 项目案例中、和ListView、SerialPort、Timer协同工作的生产级组件。本文不讲 GDI 基础 API只拆解一个已在 7 个实际产线监控系统中稳定运行超 18 个月的轻量圆形进度条实现从零封装 UserControl支持Value属性双向绑定、TextFormat自定义如显示32 N·m而非32%、ProgressColor渐变控制且所有绘制逻辑隔离在OnPaint内绝不触碰 UI 线程外的任何控件属性。新手照着抄就能跑通熟手能直接抠出关键帧逻辑集成进自己的WinForm 界面美化方案。2. 从零封装圆形进度条 UserControl用双缓冲 PathGradientBrush 实现无闪烁、高精度弧度渲染2.1 为什么不用 PictureBox 定时重绘——性能陷阱与资源泄漏真相很多初学者会想到新建一个PictureBox在Timer.Tick里CreateGraphics()画扇形再Refresh()。这看似简单但埋了三个深坑CreateGraphics()返回的Graphics对象不拥有底层设备上下文每次调用都触发 GDI 句柄分配频繁调用尤其 50Hz 以上刷新会导致GDI handle leak任务管理器里GDI Objects数持续上涨数小时后 WinForm 窗体大面积绘图失效PictureBox.Refresh()强制全区域重绘即使只改 1% 进度也重绘整个控件矩形CPU 占用飙升CreateGraphics()在非OnPaint上下文中调用绕过 .NET 的双缓冲机制必然出现撕裂、闪烁、文字锯齿尤其在高 DPI 显示器或远程桌面场景下更明显。提示真正的 WinForm 高频刷新控件必须继承UserControl并重写OnPaint把所有绘图逻辑锁死在PaintEventArgs.Graphics内这是微软官方推荐的唯一安全路径。2.2 核心类结构设计分离数据模型与视图渲染我们创建CircularProgressBar.cs继承UserControl关键字段如下public partial class CircularProgressBar : UserControl { private int _value 0; private int _maximum 100; private int _minimum 0; private Color _progressColor Color.FromArgb(255, 74, 144, 226); // 主色 private Color _backColor Color.FromArgb(230, 230, 230); // 背景环色 private string _text ; private string _textFormat {0}%; // 默认格式 private bool _showText true; private float _startAngle -90f; // 从正上方开始兼容仪表盘习惯 private float _sweepAngle 360f; // 总角度 private bool _isAnimating false; private Timer _animationTimer; }注意_startAngle -90f—— 这是工业仪表盘通用约定0° 在正上方顺时针增长不是数学极坐标系的 0° 在右侧。很多开源例子里用0f导致进度方向反向现场调试时工程师第一反应就是“这进度条转反了”。2.3 OnPaint 实现用 GraphicsPath PathGradientBrush 绘制平滑渐变弧关键绘图逻辑全部集中在OnPaint中启用双缓冲避免闪烁protected override void OnPaint(PaintEventArgs e) { base.OnPaint(e); var g e.Graphics; g.SmoothingMode SmoothingMode.AntiAlias; // 抗锯齿必开 g.TextRenderingHint TextRenderingHint.ClearTypeGridFit; // 1. 计算绘图区域居中缩放适配控件大小 RectangleF rect new RectangleF( (Width - Math.Min(Width, Height)) / 2f, (Height - Math.Min(Width, Height)) / 2f, Math.Min(Width, Height), Math.Min(Width, Height) ); // 2. 绘制背景环灰色底环 using (var backPen new Pen(_backColor, 12f)) { g.DrawArc(backPen, rect, _startAngle, _sweepAngle); } // 3. 计算当前进度弧度0~100% → 0~360° float currentSweep (_value - _minimum) * 1.0f / (_maximum - _minimum) * _sweepAngle; // 4. 创建渐变路径从中心发散模拟立体光效 using (var path new GraphicsPath()) { path.AddArc(rect, _startAngle, currentSweep); using (var gradientBrush new PathGradientBrush(path.PathPoints)) { gradientBrush.CenterColor Color.FromArgb(255, 100, 180, 255); // 亮部 gradientBrush.SurroundColors new Color[] { _progressColor }; // 暗部 gradientBrush.FocusScales new PointF(0.5f, 0.5f); using (var progressPen new Pen(gradientBrush, 12f)) { g.DrawArc(progressPen, rect, _startAngle, currentSweep); } } } // 5. 绘制中心文本支持自定义格式 if (_showText !string.IsNullOrEmpty(_text)) { string displayText string.Format(_textFormat, _text); using (var font new Font(Segoe UI, 12f, FontStyle.Bold)) using (var brush new SolidBrush(Color.FromArgb(255, 60, 60, 60))) { var textSize g.MeasureString(displayText, font); var textX (Width - textSize.Width) / 2f; var textY (Height - textSize.Height) / 2f 3f; // 微调垂直居中 g.DrawString(displayText, font, brush, textX, textY); } } }参数说明SmoothingMode.AntiAlias开启抗锯齿否则弧线边缘全是马赛克PathGradientBrush比LinearGradientBrush更适合环形模拟真实仪表盘的中心高光FocusScales new PointF(0.5f, 0.5f)让渐变焦点落在路径中心避免偏移textY加3f因MeasureString对Bold字体高度估算偏小实测需手动下移 3px 才视觉居中。3. 支持线程安全更新与动画用 InvokeRequired Timer 实现跨线程 Value 设置不崩溃3.1 为什么直接progressBar.Value 45在串口回调里会崩WinForm 控件不是线程安全的。当你在SerialPort.DataReceived事件运行在 IO 线程或Task.Run后台任务中直接修改Value属性会触发InvalidOperationException: Cross-thread operation not valid。常见错误写法// ❌ 危险在 SerialPort.DataReceived 中直接赋值 private void serialPort1_DataReceived(object sender, SerialDataReceivedEventArgs e) { string data serialPort1.ReadExisting(); int torque ParseTorque(data); // 如解析 Power Focus 6000 扭矩值 circularProgressBar1.Value torque; // 崩溃 }3.2 正确做法封装线程安全的 SetValue 方法在CircularProgressBar.cs中添加public void SetValue(int value) { if (InvokeRequired) { // 当前线程非 UI 线程委托回 UI 线程执行 BeginInvoke(new Actionint(SetValue), value); return; } // UI 线程内安全设置 if (value _minimum) value _minimum; if (value _maximum) value _maximum; _value value; Invalidate(); // 触发重绘不阻塞线程 }调用时直接传原始数据无需关心线程// ✅ 安全无论在哪条线程调用都 OK private void serialPort1_DataReceived(object sender, SerialDataReceivedEventArgs e) { string data serialPort1.ReadExisting(); int torque ParseTorque(data); circularProgressBar1.SetValue(torque); // 自动判断线程并委托 }3.3 添加平滑动画用 Timer 实现 10 帧/秒渐进式填充纯Invalidate()是瞬时跳变工业场景需要“指针缓缓转动”的观感。我们在控件内部集成一个Timerprivate void InitializeAnimation() { _animationTimer new Timer(); _animationTimer.Interval 100; // 10 FPS _animationTimer.Tick AnimationTimer_Tick; } private void AnimationTimer_Tick(object sender, EventArgs e) { if (_isAnimating _currentAnimatedValue ! _value) { // 线性插值每帧走 10% int delta (_value - _currentAnimatedValue) / 10; if (Math.Abs(delta) 1) delta _value _currentAnimatedValue ? 1 : -1; _currentAnimatedValue delta; if ((_value _currentAnimatedValue delta 0) || (_value _currentAnimatedValue delta 0)) { _currentAnimatedValue _value; _animationTimer.Stop(); _isAnimating false; } Invalidate(); // 触发重绘 } } // 公共方法开启动画式更新 public void SetValueAnimated(int value) { if (InvokeRequired) { BeginInvoke(new Actionint(SetValueAnimated), value); return; } _value Math.Max(_minimum, Math.Min(_maximum, value)); _isAnimating true; _currentAnimatedValue _currentAnimatedValue 0 ? _minimum : _currentAnimatedValue; if (!_animationTimer.Enabled) _animationTimer.Start(); }注意_currentAnimatedValue是私有字段仅用于动画插值Value属性 getter/setter 仍操作_value保证数据一致性。4. 避坑指南WinForm 圆形进度条开发中 4 个血泪经验总结4.1 现象进度条在高 DPI 缩放125%/150%下严重变形圆变椭圆原因未启用SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.ResizeRedraw, true)且OnPaint中未使用ClientSize或DisplayRectangle而是硬编码Width/Height。Windows DPI 缩放时Width返回的是逻辑像素而Graphics绘图使用物理像素比例失配。解决在构造函数中添加SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.ResizeRedraw | ControlStyles.AllPaintingInWmPaint, true);并在OnPaint中统一用ClientSize计算rect而非Width/Height。4.2 现象多个圆形进度条同时刷新时 CPU 占用率飙升至 30%原因每个控件独立Timer且Interval100ms5 个控件即每 20ms 就有 1 次Invalidate()触发 5 次重绘Graphics创建开销叠加。解决全局单例System.Windows.Forms.Timer由父窗体统一驱动所有圆形进度条的Invalidate()子控件只响应OnPaint不持有Timer。4.3 现象TextFormat {0} N·m时单位符号·显示为方块或乱码原因Segoe UI字体默认不包含 Unicode 中的中间点U00B7·需显式指定支持该字符的字体如Microsoft Sans Serif或嵌入Arial Unicode MS。解决在OnPaint文本绘制段替换字体using (var font new Font(Microsoft Sans Serif, 12f, FontStyle.Bold))4.4 现象打包成安装程序WiX/Inno Setup后进度条在客户机器上不显示仅留空白原因PathGradientBrush依赖 GDI 的高级渲染能力在老旧系统如 Windows Server 2008 R2或精简版系统中可能降级失败回退到SolidBrush但未做容错处理。解决添加 GDI 兼容兜底try { // 原 PathGradientBrush 绘制逻辑 } catch (Exception) { // 降级为 SolidBrush using (var solidBrush new SolidBrush(_progressColor)) using (var progressPen new Pen(solidBrush, 12f)) { g.DrawArc(progressPen, rect, _startAngle, currentSweep); } }5. 进阶技巧绑定 Power Focus 6000 扭矩值 动态颜色预警 WinForm 界面美化集成5.1 直接对接 Power Focus 6000串口协议解析与实时映射Power Focus 6000 扭矩传感器通过 RS232 输出 ASCII 协议典型响应为T0032.5\r\n表示 32.5 N·m。我们封装一个解析器并绑定到圆形进度条public class PowerFocus6000Reader { private SerialPort _port; private CircularProgressBar _progressBar; public PowerFocus6000Reader(string portName, CircularProgressBar progressBar) { _port new SerialPort(portName, 9600, Parity.None, 8, StopBits.One); _progressBar progressBar; _port.DataReceived Port_DataReceived; } private void Port_DataReceived(object sender, SerialDataReceivedEventArgs e) { try { string response _port.ReadTo(\r\n); if (response.StartsWith(T)) { string torqueStr response.Substring(1).Trim(); if (double.TryParse(torqueStr, out double torqueValue)) { // 映射到进度条范围0~100 N·m → 0~100% int displayValue (int)Math.Round(Math.Max(0, Math.Min(100, torqueValue))); _progressBar.SetValueAnimated(displayValue); // 动态更新文本显示带单位的值 _progressBar.Text torqueValue.ToString(F1); _progressBar.TextFormat {0} N·m; } } } catch { /* 忽略解析异常保持健壮 */ } } }调用方式在主窗体Load事件中private void MainForm_Load(object sender, EventArgs e) { var reader new PowerFocus6000Reader(COM3, circularProgressBar1); reader.Start(); // 启动串口监听 }5.2 动态颜色预警根据扭矩值自动切换进度条颜色工业场景要求“超限告警可视化”。我们扩展CircularProgressBar添加ValueColorMapping属性public Dictionaryint, Color ValueColorMapping { get; set; } new() { { 0, Color.FromArgb(255, 200, 200, 200) }, // 0%灰 { 70, Color.FromArgb(255, 74, 144, 226) }, // 70%蓝 { 90, Color.FromArgb(255, 255, 165, 0) }, // 90%橙 { 100, Color.FromArgb(255, 220, 20, 60) } // 100%红 }; // 在 OnPaint 中根据当前 _value 查找对应颜色 private Color GetCurrentProgressColor() { var keys ValueColorMapping.Keys.OrderBy(x x).ToArray(); for (int i keys.Length - 1; i 0; i--) { if (_value keys[i]) return ValueColorMapping[keys[i]]; } return ValueColorMapping[keys[0]]; }这样当扭矩达到 95 N·m 时进度条自动变为橙红色无需额外逻辑干预。5.3 WinForm 界面美化集成与 Modern UI 风格统一要融入WinForm 界面美化体系如使用Krypton Toolkit或自定义主题只需重写OnPaintBackground并禁用默认背景绘制protected override void OnPaintBackground(PaintEventArgs e) { // 不绘制背景由父容器统一处理如 KryptonPanel 的渐变背景 // base.OnPaintBackground(e); // 注释掉此行 }再配合BackColor Color.Transparent即可完美嵌入任何主题容器中实现“圆形进度条不突兀、不割裂”的视觉效果。我过去三年在 12 个 WinForm 上位机项目里反复打磨这个控件最深的体会是别信“网上下载的源码”一定要亲手跑一遍serialPort.ReadExisting()到SetValueAnimated()的全链路盯着任务管理器的 GDI Objects 和 CPU 曲线看 10 分钟——这才是检验它能不能进产线的唯一标准。希望帮到你。本文还有配套的精品资源点击获取