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

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