Skip to page content

环形进度条

QCircularProgress 组件用于显示彩色的环形进度指示器。进度条既可以展示确定的进度值,也可以显示不确定状态的加载动画。适合在后台任务执行时提示用户操作正在进行中。

用法

默认情况下,QCircularProgress 会继承当前文本颜色(作为弧形进度颜色和内部标签颜色)以及当前字体大小(作为组件大小)。如需自定义,可以使用与大小和颜色相关的属性。

在下面的示例中,show-value 属性同时启用了默认插槽,因此您可以在其中放置自定义内容,比如 QAvatar 或 QTooltip。font-size 属性指的是内部标签的字体大小。

无障碍访问
v2.25+

QCircularProgress 暴露 role="progressbar"aria-valuemin/aria-valuemax 取自 min/max 属性,aria-valuenow 跟踪当前值(在 indeterminate 模式下会省略,符合规范要求)。默认没有无障碍名称,所以请添加 aria-label 来告诉屏幕阅读器用户当前的进度代表什么——例如"正在上传附件",而不只是一个数字。