【Qt控件之QTabWidget】介绍及使用

描述

QTabWidget类提供了一个带有选项卡的小部件堆栈。
在这里插入图片描述

选项卡小部件提供了一个选项卡栏（参见QTabBar）和一个“页面区域”，用于显示与每个选项卡相关联的页面。默认情况下，选项卡栏显示在页面区域的上方，但可以使用不同的配置（参见TabPosition）进行更改。每个选项卡与不同的小部件（称为页面）相关联。只有当前页面在页面区域中显示，其他所有页面都被隐藏。用户可以通过单击选项卡或按下其Alt+字母快捷键（如果有的话）来显示不同的页面。

使用方式

使用QTabWidget的常规方式如下：

创建一个QTabWidget对象。
为选项卡对话框中的每个页面创建一个QWidget，但不为它们指定父窗口小部件。
使用布局将子窗口小部件插入页面小部件，以正常的方式定位它们。
使用addTab()或insertTab()将页面小部件放入选项卡窗口小部件中，并为每个选项卡提供适当的标签，可以选择性地添加键盘快捷键。

选项卡的位置由tabPosition定义，其形状由tabShape定义。

当用户选择一个页面时，将触发currentChanged()信号。

当前页面索引可通过currentIndex()获得，当前页面小部件可通过currentWidget()获得。您可以使用widget()检索具有给定索引的页面小部件，并可以使用indexOf()找到小部件的索引位置。使用setCurrentWidget()或setCurrentIndex()来显示特定页面。

您可以使用setTabText()或setTabIcon()更改选项卡的文本和图标。可以使用removeTab()删除选项卡及其相关页面。

每个选项卡在任何给定时间都可以启用或禁用（参见setTabEnabled()）。如果选项卡启用，选项卡文本将以正常方式绘制，用户可以选择该选项卡。如果选项卡禁用，选项卡将以不同的方式绘制，用户无法选择该选项卡。
请注意，即使选项卡被禁用，页面仍然可以可见，例如，如果所有选项卡都恰好被禁用。

选项卡小部件可以很好地将复杂的对话框分割成多个部分。另一种选择是使用QStackedWidget，您可以为其提供一些导航方式，例如QToolBar或QListWidget。

QTabWidget中的大部分功能由QTabBar（位于顶部，提供选项卡）和QStackedWidget（大部分区域，组织个别页面）提供。

常用函数

枚举类型 QTabWidget::TabPosition

此枚举类型定义了 QTabWidget 绘制选项卡行的位置：

常量	值	描述
QTabWidget::North	0	选项卡绘制在页面上方。
QTabWidget::South	1	选项卡绘制在页面下方。
QTabWidget::West	2	选项卡绘制在页面左侧。
QTabWidget::East	3	选项卡绘制在页面右侧。

枚举类型 QTabWidget::TabShape

此枚举类型定义了选项卡的形状：

常量	值	描述
QTabWidget::Rounded	0	选项卡以圆角形状绘制。这是默认形状。
QTabWidget::Triangular	1	选项卡以三角形形状绘制。

成员函数介绍（部分）：

addTab(QWidget *widget, const QString &label): 向QTabWidget中添加一个选项卡，关联指定的小部件和标签。
insertTab(int index, QWidget *widget, const QStringlabel): 在指定的位置插入一个选项卡，关联指定的小部件和标签。
removeTab(int index): 移除指定位置的选项卡及其关联的页面小部件。
setCurrentWidget(QWidget *widget): 设置当前显示的页面为指定的小部件。
setCurrentIndex(int index): 设置当前显示的页面为指定的索引位置。
currentWidget(): 返回当前显示的页面小部件。
currentIndex(): 返回当前显示页面的索引位置。
setTabText(int index, const QString &text): 修改指定索引位置的选项卡的文本。
setTabIcon(int index, const QIcon &icon): 修改指定索引位置的选项卡的图标。
setTabToolTip(int index, const QString &tooltip): 设置定索引位置的选项卡的工具提示。
setTabEnabled(int index, bool enabled): 设置指定索引位置的选项卡的启用状态。
count(): 返回选项卡的数量。
tabBar(): 返回QTabBar对象，用于访问和修改选项卡栏的属性和样式。
tabPosition(): 返回当前选项卡栏的位置。
tabShape(): 返回当前选项卡的形状。
tabText(int index): 返回指定索引位置的选项卡的文本。
tabIcon(int index): 返回指定索引位置的选卡的图标。

示例

UI效果：
在这里插入图片描述

#include <QApplication>
#include <QTabWidget>
#include <QPushButton>
#include <QIcon>int main(int argc, char *argv[]) {QApplication app(argc, argv);QTabWidget tabWidget;// 添加按钮用于动态添加tabQPushButton addButton("Add Tab");QObject::connect(&addButton, &QPushButton::clicked, [&]() {static int index = 1;QString text = "Tab " + QString::number(index);QWidget *widget = new QWidget();tabWidget.addTab(widget, text); // 添加新的tabindex++;});// 插入按钮用于在当前tab之后插入新的tabQPushButton insertButton("Insert Tab");QObject::connect(&insertButton, &QPushButton::clicked, [&]() {static int index = 1;QString text = "Tab " + QString::number(index);QWidget *widget = new QWidget();int currentIndex = tabWidget.currentIndex();tabWidget.insertTab(currentIndex + 1, widget, text); // 插入新的tabindex++;});// 关闭按钮用于关闭当前选中的tabQPushButton closeButton("Close Tab");QObject::connect(&closeButton, &QPushButton::clicked, [&]() {int currentIndex = tabWidget.currentIndex();tabWidget.removeTab(currentIndex); // 关闭当前选中的tab});// 修改按钮用于改变当前选中tab的图标和文本QPushButton modifyButton("Modify Tab");QObject::connect(&modifyButton, &QPushButton::clicked, [&]() {int currentIndex = tabWidget.currentIndex();QIcon newIcon(":/newIcon.png");QString newText = "Modified Tab";tabWidget.setTabIcon(currentIndex, newIcon); // 修改当前选中tab的图标tabWidget.setTabText(currentIndex, newText); // 修改当前选中tab的文本});// 将按钮添加到QTabWidget中tabWidget.addTab(&addButton, "Add");tabWidget.addTab(&insertButton, "Insert");tabWidget.addTab(&closeButton, "Close");tabWidget.addTab(&modifyButton, "Modify");tabWidget.show();return app.exec();
}