C++ Qt開發：ProgressBar進度條元件

lyshark發表於2023-12-15
C++QT元件

Qt 是一個跨平臺C++圖形介面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以透過拖拽的方式將不同元件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹ProgressBar進度條元件的常用方法及靈活運用。

ProgressBar（進度條）是在Qt中常用的使用者介面元件之一，用於顯示任務的完成進度。它通常以一個水平或垂直的條形圖形式展示，表示任務已完成的比例。進度條元件提供了一種直觀的方式來顯示任務的進度，讓使用者清晰地瞭解任務的完成情況。其還可根據需要在水平或垂直方向上顯示，以適應不同的介面佈局。

以下是QProgressBar類的一些常用方法的說明和概述，以表格形式列出：

方法 描述
QProgressBar(QWidget *parent = nullptr) 建構函式，建立一個元件物件。
setRange(int minimum, int maximum) 設定元件的範圍，即任務的最小和最大值。
setValue(int value) 設定元件的當前值，即任務已完成的進度。
value() const 獲取元件的當前值。
setMinimum(int minimum) 設定元件的最小值。
setMaximum(int maximum) 設定元件的最大值。
reset() 重置元件，將當前值設定為最小值。
minimum() const 獲取元件的最小值。
maximum() const 獲取元件的最大值。
text() const 獲取元件顯示的文字，通常是百分比值。
setFormat(const QString &format) 設定元件顯示文字的格式，支援百分比等。
setAlignment(Qt::Alignment alignment) 設定元件文字的對齊方式。
setInvertedAppearance(bool invert) 設定元件是否顯示為反向進度（從右到左）。
setOrientation(Qt::Orientation orientation) 設定元件的方向，可以是水平或垂直。
setStyleSheet(const QString &styleSheet) 設定元件的樣式表。
setFormat(const QString &format) 設定元件的顯示格式。
setAlignment(Qt::Alignment alignment) 設定元件文字的對齊方式。

這些方法提供了對QProgressBar進行配置、管理和與之互動的靈活性。你可以根據具體的應用需求使用這些方法，使QProgressBar在你的Qt應用程式中按照期望的方式工作。

說到進度條元件就不得不提起定時器類，因為進度條元件往往需要配合定時器一起使用，QTimer是 Qt 中用於建立定時器的類，它允許你在一段時間間隔後執行特定的操作。以下是 QTimer 類的一些常用方法的說明和概述，以表格形式列出：

方法 描述
QTimer(QObject *parent = nullptr) 建構函式，建立一個定時器物件。
start(int msec) 啟動定時器，指定觸發時間間隔（以毫秒為單位）。
stop() 停止定時器，阻止進一步的定時觸發。
setInterval(int msec) 設定定時器的觸發時間間隔。
setSingleShot(bool singleShot) 設定定時器是單次觸發還是重複觸發。
isActive() const 檢查定時器是否處於活動狀態。
remainingTime() const 返回離下一次定時器觸發還有多少時間，如果不活動返回 -1。
timeout 在定時器超時時發出，可以與槽函式連線以執行相應操作。
setTimerType(Qt::TimerType atype) 設定定時器的型別，可以是 PreciseTimer 或 CoarseTimer。
timerType() const 返回定時器的型別。
setSingleShot(bool singleShot) 設定定時器是單次觸發還是重複觸發。
interval() const 返回定時器的觸發時間間隔。
timeout() 返回 timeout 訊號的 QMetaObject::Connection 物件。

這些方法提供了對 QTimer 進行配置、管理和與之互動的靈活性。你可以根據具體的應用需求使用這些方法，使 QTimer 在你的 Qt 應用程式中按照期望的方式工作。

首先在MainWindow主函式中透過connect設定繫結定時器，並在匿名函式中對數值進行判斷，如果到達了進度條最大值則直接使用my_timer->stop()停止計時，否則每次設定進度條加一，程式碼如下所示；

#include <QTimer>

// 全域性定時器變數指標
QTimer *my_timer;

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 宣告定時器
     my_timer = new QTimer(this);

     // 繫結一個匿名函式
     connect(my_timer,&QTimer::timeout,[=]{
         static int x = 0;

         // 判斷是否到達了進度條的最大值
         if(x != 100)
         {
             x++;
             ui->progressBar_Up->setValue(x);
             ui->progressBar_Down->setValue(int(100-x));
         }
         else
         {
             x=0;
             my_timer->stop();
         }
     });
}

當使用者點選初始化按鈕時，我們首先將兩個進度條使用reset()屬性進行重置，接著設定progressBar_Down為最大值狀態，程式碼如下所示；

// 初始化進度條
void MainWindow::on_pushButton_clear_clicked()
{
    // 清空進度條
    ui->progressBar_Up->reset();
    ui->progressBar_Down->reset();

    // 設定遞減進度條最大值100
    ui->progressBar_Down->setValue(100);
}

啟動與停止定時器流程一致，首先透過my_timer->isActive()來驗證定時器是否啟動中，日過不是則my_timer->start(100)啟動，如果是則my_timer->stop()停止。

// 啟動定時器,並設定週期為100毫秒
void MainWindow::on_pushButton_start_clicked()
{
    if(my_timer->isActive() == false)
    {
        my_timer->start(100);
    }
}

// 停止定時器
void MainWindow::on_pushButton_stop_clicked()
{
    if(my_timer->isActive() == true)
    {
        my_timer->stop();
    }
}

執行程式，首先點選初始化按鈕設定進度條的狀態值，然後讀者可點選啟動定時器和停止定時器，如下圖所示；

相關文章