C++ Qt開發:StatusBar底部狀態欄組件

Qt 是一個跨平臺C++圖形界面開發庫,利用Qt可以快速開發跨平臺窗體應用程序,在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置,實現圖形化開發極大的方便了開發效率,本章將重點介紹QStatusBar底部狀態欄組件的常用方法及靈活運用。

QStatusBar 是 Qt 中用於在主窗口底部顯示狀態信息的部件。它通常用於向用戶提供應用程序的當前狀態、進度信息、或者其他與應用程序運行相關的消息。通過在狀態欄上顯示文本、永久部件、進度條等內容,可以爲用戶提供清晰的反饋和實時信息。在設計應用程序界面時,使用狀態欄有助於提升用戶體驗。

下面是 QStatusBar 的一些常用方法,以表格形式概述它們的功能:

方法 描述
addPermanentWidget(QWidget *widget, int stretch = 0) 將一個永久部件添加到狀態欄,並可以設置部件在狀態欄中的拉伸因子。永久部件會一直顯示在狀態欄上。
addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = 0) 將一個部件添加到狀態欄,並可以設置部件在狀態欄中的拉伸因子和對齊方式。
removeWidget(QWidget *widget) 從狀態欄中移除指定的部件。
addPermanentWidget(QWidget *widget, int stretch = 0) 將一個永久部件添加到狀態欄,並可以設置部件在狀態欄中的拉伸因子。永久部件會一直顯示在狀態欄上。
removeWidget(QWidget *widget) 從狀態欄中移除指定的部件。
clearMessage() 清除狀態欄上的當前消息。
clear() 移除狀態欄上的所有部件和消息。
insertPermanentWidget(int index, QWidget *widget, int stretch = 0) 在指定索引位置插入一個永久部件。永久部件會一直顯示在狀態欄上。
insertWidget(int index, QWidget *widget, int stretch = 0, Qt::Alignment alignment = 0) 在指定索引位置插入一個部件。
insertPermanentWidget(int index, QWidget *widget, int stretch = 0) 在指定索引位置插入一個永久部件。永久部件會一直顯示在狀態欄上。
showMessage(const QString &text, int timeout = 0) 在狀態欄上顯示一條臨時消息。可以指定顯示的時間,如果設置爲0,則消息會一直顯示,直到下一條消息出現或者被清除。
currentMessage() 返回狀態欄上當前顯示的消息。
messageChanged(const QString &message) 當狀態欄上的消息改變時觸發的信號。

這些方法提供了豐富的功能,允許你動態地管理狀態欄上的部件和消息。通過調用這些方法,你可以在狀態欄上添加、刪除、插入部件,顯示臨時消息,清除消息等,以滿足不同應用場景的需求。

1.1 QLabel組件顯示

在默認情況下新建的窗體程序都會自帶一個StatusBar組件,可在項目右側的Filter處看到,該組件可以與其它任意的通用組件配合使用,首先我們先將一個QLabel標籤組件安置在底部狀態欄中,代碼如下所示;

#include <QLabel>

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

    // 初始化狀態欄
    QLabel *labCellIndex = new QLabel("當前座標: 0.0",this);
    labCellIndex->setMinimumWidth(150);

    QLabel *labCellType=new QLabel("單元格類型: null",this);
    labCellType->setMinimumWidth(100);

    QLabel *labStudID=new QLabel("學生ID: 0",this);
    labStudID->setMinimumWidth(100);

    // 將初始化的標籤添加到底部狀態欄上
    ui->statusbar->addWidget(labCellIndex);
    ui->statusbar->addWidget(labCellType);
    ui->statusbar->addWidget(labStudID);
}

運行後則可以將三個標籤組件內嵌到窗體最底部,如下圖所示;

QLabel組件除了可以增加提示信息以外,通過設置setOpenExternalLinks可以將這個組件設置爲以鏈接形式出現,有利於我們增加網頁跳轉等功能。

#include <QLabel>

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

    // 隱藏狀態欄下方三角形
    ui->statusbar->setSizeGripEnabled(false);

    // 新增標籤欄
    QLabel *label_url = new QLabel(this);
    QLabel *label_about = new QLabel(this);

    // 配置連接
    label_url->setFrameStyle(QFrame::Box | QFrame::Sunken);
    label_url->setText(tr("<a href=\"https://www.lyshark.com\">訪問主頁</a>"));
    label_url->setOpenExternalLinks(true);

    label_about->setFrameStyle(QFrame::Box | QFrame::Sunken);
    label_about->setText(tr("<a href=\"https://www.lyshark.com\">關於我</a>"));
    label_about->setOpenExternalLinks(true);

    // 將信息增加到底部(永久添加)
    ui->statusbar->addPermanentWidget(label_url);
    ui->statusbar->addPermanentWidget(label_about);
}

上述代碼運行後將會在窗體最右側新建兩個可以點擊的超鏈接,並永久固定在窗體底部,如下圖所示;

1.2 QProgressBar組件顯示

進度條組件的使用方法與標籤一樣,同樣需要通過new的方式動態生成,當配置好進度條屬性後,只需要通過addPermanentWidget將其添加到底部菜單欄即可,代碼如下所示;

#include <QLabel>
#include <QProgressBar>

QProgressBar *pro;

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

    // 隱藏狀態欄下方三角形
    ui->statusbar->setSizeGripEnabled(false);

    pro = new QProgressBar(this);

    // 添加進度條
    ui->statusbar->addPermanentWidget(pro, 1);

    // 設置進度是否顯示
    pro->setTextVisible(true);

    // 設置樣式表,使用 width 控制寬度 height控制高度
    pro->setStyleSheet("QProgressBar { min-width: 400px; max-width: 10px; min-height: 10px; max-height: 10px; }");

    // 設置初始化進度位置
    pro->setValue(74);
}

MainWindow::~MainWindow()
{
    delete ui;
}

// 遞增進度
void MainWindow::on_pushButton_add_clicked()
{
    qint32 count = pro->value();
    count = count +10;
    pro->setValue(count);
}

// 遞減進度
void MainWindow::on_pushButton_sub_clicked()
{
    qint32 count = pro->value();
    count = count - 10;
    pro->setValue(count);
}

運行後效果如下圖所示,當點擊遞增進度時子等增加10,點擊遞減進度是則自動減少10;

1.3 QtableWidget組件交互

接着我們來看一下如何與TableWidget實現交互,在tableWidget組件中存在一個on_tableWidget_currentCellChanged屬性,該屬性的作用是,只要表格存在變化則會觸發,當用戶選擇不同的表格是,我們可以動態將當前表格行列自動設置到狀態欄中,從而實現同步狀態欄消息提示,起到時刻動態顯示的作用。

首先對圖形界面中的表格進行初始化,在MainWindow構造函數中使用如下代碼完成初始化;

#include <QLabel>
#include <QTableWidget>
#include <QTableWidgetItem>

QLabel *labCellIndex;

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

    // ----------------------------------------------------
    // 初始化狀態欄
    // ----------------------------------------------------
    labCellIndex = new QLabel("當前座標: 0.0",this);
    labCellIndex->setMinimumWidth(250);

    // 將初始化的標籤添加到底部狀態欄上
    ui->statusbar->addWidget(labCellIndex);

    // ----------------------------------------------------
    // 填充數據,對錶格進行初始化操作
    // ----------------------------------------------------
    QStringList header;
    header << "姓名" << "性別" << "年齡";

    ui->tableWidget->setColumnCount(header.size());                        // 設置表格的列數
    ui->tableWidget->setHorizontalHeaderLabels(header);                    // 設置水平頭
    ui->tableWidget->setRowCount(5);                                       // 設置總行數
    ui->tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);   // 設置表結構默認不可編輯

    // ----------------------------------------------------
    // 填充數據
    // ----------------------------------------------------
    QStringList NameList;
    NameList << "張三" << "李四" << "王五";

    QStringList SexList;
    SexList << "男" << "男" << "女";

    qint32 AgeList[3] = {22,23,43};

    // 針對獲取元素使用 NameList[x] 和使用 NameList.at(x)效果相同
    for(int x=0;x< 3;x++)
    {
        int col =0;
        // 添加姓名
        ui->tableWidget->setItem(x,col++,new QTableWidgetItem(NameList[x]));
        // 添加性別
        ui->tableWidget->setItem(x,col++,new QTableWidgetItem(SexList.at(x)));
        // 添加年齡
        ui->tableWidget->setItem(x,col++,new QTableWidgetItem( QString::number(AgeList[x]) ) );
    }
}

此時,當表格元素髮生變化時,只需要通過setText屬性將表格位置刷新到標籤組件中即可實現,如下代碼;

void MainWindow::on_tableWidget_currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)
{
    Q_UNUSED(previousRow);
    Q_UNUSED(previousColumn);

    // 顯示行與列的變化數值
    std::cout << "currentRow = " << currentRow << " currentColumn = " << currentColumn << std::endl;
    std::cout << "pre Row = " << previousRow << " pre Column = " << previousColumn << std::endl;

    // 獲取當前單元格的Item
    QTableWidgetItem *item = ui->tableWidget->item(currentRow,currentColumn);
    if(item == NULL)
    {
        return;
    }

    // 設置單元格座標
    labCellIndex->setText(QString::asprintf("當前座標: %d 行 | %d 列",currentRow,currentColumn));
}

運行後選擇不同的行實現刷新,如下所示;

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章