当前位置：首页 > article >正文

qt QProgressBar总结

article 2025/2/27 2:39:42

1. 基本用法

作用：显示操作进度（如文件下载、数据处理等）。

创建：

QProgressBar *progressBar = new QProgressBar(parent);

2. 主要属性

属性	描述	方法示例
范围 (Range)	进度条的取值范围（默认 0-99）	`setRange(min, max)`
当前值 (Value)	当前进度值	`setValue(int)` 或 `value()`
文本格式 (Text)	显示进度文本的格式	`setFormat("%p%")`（默认显示百分比）
方向 (Orientation)	水平或垂直	`setOrientation(Qt::Vertical)`
文本可见性	是否显示进度文本	`setTextVisible(false)`
对齐方式	文本对齐方式	`setAlignment(Qt::AlignCenter)`

3. 常用方法

重置进度：
```
progressBar->reset();
```

设置不确定模式（无具体进度，如滚动条）：

progressBar->setRange(0, 0); // 进入不确定模式
progressBar->setRange(0, 100); // 退出不确定模式

4. 进阶功能

样式定制

使用样式表（QSS）自定义外观：

progressBar->setStyleSheet(
    "QProgressBar { border: 2px solid grey; border-radius: 5px; }"
    "QProgressBar::chunk { background-color: #05B8CC; }"
);

动态颜色：根据进度值改变颜色（需结合事件处理）。

信号与槽

进度值变化时触发信号：

connect(progressBar, &QProgressBar::valueChanged, [](int value) {
    qDebug() << "当前进度：" << value;
});

5. 示例代码

// 创建进度条
QProgressBar *progressBar = new QProgressBar(this);
progressBar->setRange(0, 100);
progressBar->setValue(50);
progressBar->setFormat("已完成 %p%");
progressBar->setTextVisible(true);

// 模拟进度更新（如通过定时器或线程）
QTimer *timer = new QTimer(this);
connect(timer, &QTimer::timeout, [progressBar]() {
    int val = progressBar->value() + 1;
    if (val > 100) val = 0;
    progressBar->setValue(val);
});
timer->start(100);