在实际项目中，很多进度展示场景并不适合传统的横向进度条。说起来，从例如来看，

• 加载时需要一个直观的转圈动效。
• 多个关键指标需要在同一视图中对比。
• 界面空间受限，想要在圆形区域内直接显示百分比或综合评分。话说回来，

针对这些痛点。这篇文章提供两套基于 Canvas 的环形进度实现：

• 单环进度 —— 支持普通百分比模式和不确定模式。说起来，
• 多环进度 —— 同心三环。可通过滑块实时联动，适用于多指标对比仪表盘。

从Demo来看，单环进度

下面是封装好的 CircleProgress 组件。默认显示百分比，几秒后自动切换到 “加载中” 的旋转模式，再切回普通模式。

完整组件代码

import QtQuick 2.15
import QtQuick.Canvas 1.0
Item {
id的观点是，root
// ---------- 公共属性 ----------
property real value: 0 // 0~1
property bool indeterminate: false // 不确定模式开关
property int lineWidth: 12 // 环宽
property color progressColor: "#3498db" // 前景色
property color trackColor: "#e6e6e6" // 背景轨道色
property int animationDuration: 500 // 百分比变化动画时长
implicitWidth: 200
implicitHeight: 200
readonly property real radius: Math.min / 2 - lineWidth / 2
// -------- 正常进度动画 --------
property real animatedValue: value
Behavior on animatedValue {
enabled:!root.indeterminate // 不确定模式下禁用动画
NumberAnimation {
duration: root.animationDuration
easing.type: Easing.OutCubic
}
}
Canvas {
id的观点是，canvas
anchors.fill: parent
antialiasing: true
onPaint: {
var ctx = getContext;ctx.clearRect;var cx = width / 2;怎么说呢，var cy = height / 2;var r = root.radius;// ---- 背景轨道 ----
ctx.beginPath;ctx.arc，ctx.strokeStyle = root.trackColor;按理说，ctx.lineWidth = root.lineWidth;ctx.stroke，// ---- 前景进度弧 ----
var sweep = root.indeterminate?:，ctx.beginPath;ctx.arc(cx,cy,r,-Math.PI / 2。-Math.PI / 2 + sweep);ctx.strokeStyle = root.progressColor;ctx.lineWidth = root.lineWidth;ctx.lineCap = "round";ctx.stroke，}
// 属性变化时请求重绘
Connections {
再看target，root
function onAnimatedValueChanged { canvas.requestPaint;}
function onIndeterminateChanged { canvas.requestPaint;}
function onProgressColorChanged { canvas.requestPaint;}
function onTrackColorChanged { canvas.requestPaint;}
function onLineWidthChanged { canvas.requestPaint;}
}
// 不确定模式：给整个 Canvas 加旋转动画。让固定弧段转起来
RotationAnimation on rotation {
至于from，0;to: 360，duration: 1200;running: root.indeterminate;loops: Animation.Infinite;}
}
// 中心文字：百分比或“加载中”
Text {
anchors.centerIn: parent
至于text，root.indeterminate?"加载中"
: Math.round + "%"
font.pixelSize: root.radius * 0.5
font.bold: true
至于color。root.progressColor
visible: true
}
}

Demo 页面使用方式

import QtQuick 2.15
import QtQuick.Layouts 1.15
ColumnLayout {
anchors.fill : parent
anchors.margins : 20
spacing : 20
CircleProgress {
id : control
Layout.preferredWidth : parent.width * .4
Layout.preferredHeight : parent.width * .4
Layout.alignment : Qt.AlignHCenter
}
Timer {
id : timerSwitchMode
interval : 3000 // 每三秒切换一次模式，以演示两种状态的切换效果
running : true
repeat : true
onTriggered : control.indeterminate =!control.indeterminate;}
Item { Layout.fillHeight : true } // 占位，让布局居中
}

关键逻辑解析

• 为什么选用 Canvas 而非 Shape？ Shape 在每帧重新栅格化会导致卡顿且边缘出现锯齿；而 Canvas 绘制一次后缓存为纹理。随后只做 GPU 层面的变换，性能更佳且视觉更平滑。
• 绘制主要在 onPaint 仅绘制两条弧线：
  • 轨道弧：整圆，用浅色表示背景。
  • 进度弧：起点固定在顶部（-π/2)，扫过角度依据当前值计算。使用 lineCap="round" 获得圆润的端点。
• 半径计算细节：

  readonly property real radius:
  Math.min / 2 - lineWidth / 2;怎么说呢，

  若不减去线宽的一半。粗线会超出组件边界，这是画圆环时最常遗漏的细节。
• 普通模式下的平滑动画： 属性 animatedValue 配合 ` 实现数值变化的缓动；Connections`监听属性变化并调用 canvas.requestPaint` 重绘。使得进度条随数值平滑增长，同时中心文字同步更新。
• 不确定模式实现思路： 打开 indeterminate=true` 时仅绘制固定长度的弧段，并对整个 Cavas` 添加无限循环的旋转动画。因为背景是完整圆形，即使整体旋转也不会被察觉。这样就能实现“加载中”动效。

T​he three concentric rings represent CPU、Memory、Disk three key metrics. Each ring is driven by a dedicated slider;center shows a composite value.

完整代码示例

import QtQuick 2.15
import QtQuick.Controls 2.15
ColumnLayout {
anchors.fill : parent
anchors.margins : 20
spacing : 20
RowLayout {
Layout.fillWidth : true
/* ---------- 圆形仪表盘 ---------- */
Canvas {
id : multiCanvas
Layout.preferredWidth : parent.width * .5
Layout.preferredHeight : parent.width * .5
/* 与三个 Slider 双向绑定的属性 */
property real p1 : sliderCpu.value // CPU
property real p2 : sliderMem.value // Memory
property real p3 : sliderDisk.value // Disk
/* 任意属性变化即请求重绘 */
onP1Changed : requestPaint
onP2Changed : requestPaint
onP3Changed : requestPaint
onPaint:{
var ctx = getContext;ctx.clearRect;var cx = width/2;var cy = height/2;/* 三个环的配置，从外到内依次缩小半径 */
var rings =;for{
var ring = rings;
其实，/* 背景轨道 */
ctx.beginPath;ctx.arc，ctx.strokeStyle=ring.bg;ctx.lineWidth=lineWidth;ctx.stroke，/* 前景进度 */
var sweep = ring.progress*Math.PI*2;ctx.beginPath;ctx.arc，ctx.strokeStyle=ring.color;ctx.lineWidth=lineWidth;ctx.lineCap="round";ctx.stroke，}
/* 中心文字 – 综合值取第二层作为示例 */
var composite = Math.round;ctx.fillStyle="#333333";ctx.font="bold 24px sans-serif";不过，ctx.textAlign="center";ctx.textBaseline="middle";ctx.fillText;/* 小字 “综合” */
ctx.font="12px sans-serif";ctx.fillText;}
}
/* ---------- 控件 & 图例 ---------- */
ColumnLayout{
spacing :10
Layout.alignment :Qt.AlignVCenter
/* CPU */
RowLayout{
spacing :-5
Rectangle{ width:pxToDp;height:pxToDp;radius:pxToDp;color:"#E17055"}
Text{ text:"CPU";话说回来，font.pointSize:=10}
Text{ text:.toFixed+"%";font.pointSize:=10;font.bold:true;color:"#E17055"}
}
Slider{id:sliderCpu;from:.0，to:.99;value:.65，话说回来，Layout.preferredWidth:auto;}
/* Memory */
RowLayout{
spacing:-5
Rectangle{ width:pxToDp;怎么说呢，height:pxToDp;radius:pxToDp;color:"#00B894"}
Text{ text:"内存";font.pointSize:=10}
Text{ text:.toFixed+"%";font.pointSize:=10;font.bold:true;说起来，color:"#00B894"}
}
Slider{id:sliderMem;from:.0，to:.99;value:.45，Layout.preferredWidth:auto;}
/* Disk */
RowLayout{
spacing:-5
Rectangle{ width:pxToDp;height:pxToDp;radius:pxToDp;color:"#6C5CE7"}
Text{ text:"磁盘";font.pointSize:=10}
Text{ text:.toFixed+"%";font.pointSize:=10;font.bold:true;color:"#6C5CE7"}
}
Slider{id:sliderDisk;from:.0，to:.99;value:.30，Layout.preferredWidth:auto;}
}
}
Item{ Layout.fillHeight:true }
}

• A‑same‑draw‑logic as single ring: 只是在一次绘制循环里遍历数组，实现“画多遍”。每个元素包含半径、颜色、当前进度等信息，保持代码结构清晰且易于
• B‑属性驱动 Canvas 重绘： 把三个滑块的值分别绑定到 Canvas 的属性 ) 上；每当属性改变时立即调用 .requestPaint。保证 UI 与数据同步，无需手动刷新或额外计时器。
• C‑中心文字直接使用 Canvas 绘制： 避免再嵌套 QML 的 组件。从而保持所有渲染都在同一纹理上，提高渲染效率并简化层级结构。若业务需要，也可以改为 QML 文本混合使用。

从对比表格来看，单环 vs 多环

维度	单环进度	多环进度
形态	单环 + 中心百分比	三环同心 + 中心综合值
数据来源	外部属性 value	三个外部 Slider 联动
不确定模式	有 – 使用旋转动画展示“加载中”	无 – 始终展示具体数值
适用场景	单指标加载、评分或占位展示	多指标仪表盘对比、资源监控等
⚡️ 根据实际需求挑选合适方案 ⚡️   💡 如需同时兼顾两者。可把单环组件嵌入多环布局，实现混搭效果 💡  🚀 常用方法：统一使用 Canvas 绘制、属性驱动刷新 ✅  🛠️ 可 性强，可随业务动态增删圈数 ✅  🔧 支持主题色与线宽自定义 ✅     ✅

请忽略以上乱码，它们只是占位符

...

请忽略上方残余字符。

`

注：

此处提供了一个结构化对照表，使您快速判断哪种实现更契合业务需求。

---

---

---

---

---

---

--

- - - - - -

—-

—- —

—

——

---

---

---

---

---

---

---

——–

---

---

—– —– —–

---

---

)

---

至于小结，

• 使用 Canvas 能够让你比较容易做到高性能、低卡顿的圆形或同心多圈动态效果。

• 行为分离将 UI 渲染交给 Canvas。将业务状态放在 QML 属性上，通过 Connections 实现即时刷帧。

• 可 只需修改数组即可支持任意数量的指示圈，实现灵活仪表盘。

————————————————

---

从验证步骤来看，

bash

qmake && make && ./YourApp

从更多参考资料来看。

• Qt 官方文档 Canvas API
• 《QML 高级实战》章节《自定义绘图》

---

。

---