C++ Qt开发：StatusBar底部状态栏组件

发表于 2023-12-21 分类于《Qt Creator 编程技术实践》

Qt 是一个跨平台C++图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本章将重点介绍`QStatusBar`底部状态栏组件的常用方法及灵活运用。`QStatusBar` 是 Qt 中用于在主窗口底部显示状态信息的部件。它通常用于向用户提供应用程序的当前状态、进度信息、或者其他与应用程序运行相关的消息。通过在状态栏上显示文本、永久部件、进度条等内容，可以为用户提供清晰的反馈和实时信息。在设计应用程序界面时，使用状态栏有助于提升用户体验。

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));
}

运行后选择不同的行实现刷新，如下所示；