import QtQuick.Controls 2.5
ProgressBar 表示操作的进度。value 应定期更新,范围由 from 和 to 定义,两者都可以包含任何值。
ProgressBar 还支持特殊的 indeterminate 模式。
例如,当无法确定正在下载的项目的大小时,或者由于网络断开而导致下载进度中断时,这种模式非常有用。
indeterminate 模式类似于 BusyIndicator。两者都可用于指示背景活动。
主要区别在于视觉,ProgressBar 也可以呈现具体的进度(当可以确定时)。
由于视觉差异,不确定的进度条和繁忙指示符适合用户界面中的不同位置。
不确定进度条的典型位置:
- 在 ToolBar 的底部
- 内联在页面内容中
- 在 ItemDelegate 中显示特定项目的进度
属性
-
from
:(real,默认为 0.0) -
to
:(real,默认为1.0) -
value
:(real,默认为 0.0) -
indeterminate
:(bool,默认为 false)
此属性保存进度条是否处于不确定模式。
不确定模式下的进度条显示操作正在进行,但未显示已进行了多少进度。 -
position
:(real)
此属性控制进度的逻辑位置。该位置表示为该值的一部分,范围为 0.0-1.0。
为了可视化进度,应该使用从右到左识别的 visualPosition。 -
visualPosition
:(real)
此属性控制进度的视觉位置。该位置表示为该值的一部分,范围为 0.0-1.0。
当镜像控件时,visuaPosition 等于1.0 - position。这使得 visualPosition 适合于可视化进度,同时考虑从右到左的支持。