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

qt QProgressBar详解

article 2024/12/27 15:38:25

1、概述

QProgressBar是Qt框架中的一个控件，专门用于显示任务的进度。它提供了一个可视化的进度条，让用户能够直观地了解任务的完成程度。QProgressBar支持水平和垂直两种显示方向，并且可以通过设置最小值和最大值来指定进度条的范围。此外，QProgressBar还允许自定义样式，以满足不同的用户界面需求。

2、重要方法

QProgressBar类提供了多种方法来配置和控制进度条的行为：

设置范围：
- setRange(int minimum, int maximum)：设置进度条的最小值和最大值。
- setMinimum(int minimum)：单独设置进度条的最小值。
- setMaximum(int maximum)：单独设置进度条的最大值。
设置当前值：
- setValue(int value)：设置进度条的当前值。
- value()：获取进度条的当前值。
重置进度条：
- reset()：将进度条的当前值重置为最小值（通常用于重新开始任务）。
设置方向：
- setOrientation(Qt::Orientation orientation)：设置进度条的方向为水平或垂直。
设置外观：
- setInvertedAppearance(bool inverted)：如果设置为true，则进度条的方向将与其默认方向相反。
- setTextVisible(bool visible)：设置是否显示进度条上的文本（通常是当前值的百分比）。
- setFormat(const QString &format)：自定义进度条上显示的文本格式。可以使用%p表示百分比，%v表示当前值，%m表示总值。
其他方法：
- setAlignment(Qt::Alignment alignment)：设置进度条上文本的对齐方式。

3、重要信号

QProgressBar类提供了一个重要的信号来通知开发者进度条的变化：

valueChanged(int value)：当进度条的当前值发生变化时发出。这个信号携带新的整数值作为参数，表示进度条的当前值。

#include <QApplication>  
#include <QWidget>  
#include <QVBoxLayout>  
#include <QProgressBar>  
#include <QTimer>  
#include <QLabel>  
  
class MyWidget : public QWidget {  
    Q_OBJECT  
  
public:  
    MyWidget(QWidget *parent = nullptr) : QWidget(parent) {  
        QVBoxLayout *layout = new QVBoxLayout(this);  
  
        QProgressBar *progressBar = new QProgressBar(this);  
        progressBar->setRange(0, 100);  
        progressBar->setValue(0);  
        progressBar->setAlignment(Qt::AlignCenter);  
  
        QLabel *label = new QLabel("进度: 0%", this);  
  
        QTimer *timer = new QTimer(this);  
        connect(timer, &QTimer::timeout, this, &MyWidget::updateProgressBar);  
  
        layout->addWidget(progressBar);  
        layout->addWidget(label);  
  
        setLayout(layout);  
  
        // 启动定时器，每隔100毫秒更新一次进度条  
        timer->start(100);  
    }  
  
private slots:  
    void updateProgressBar() {  
        QProgressBar *progressBar = findChild<QProgressBar*>();  
        QLabel *label = findChild<QLabel*>();  
  
        if (progressBar && label) {  
            int currentValue = progressBar->value();  
            if (currentValue < 100) {  
                progressBar->setValue(currentValue + 1);  
                label->setText(QString("进度: %1%").arg(currentValue + 1));  
            } else {  
                // 停止定时器  
                QTimer *timer = findChild<QTimer*>();  
                if (timer) {  
                    timer->stop();  
                }  
                label->setText("任务完成！");  
            }  
        }  
    }  
};  
  
int main(int argc, char *argv[]) {  
    QApplication app(argc, argv);  
  
    MyWidget widget;  
    widget.show();  
  
    return app.exec();  
}