Qt QTabWidget详解

wuxinit_ 2023-10-30 发布于湖北

展开全文

一、介绍

Qt QTabWidget是一种带有页签(tab)的窗口控件，可用于在同一个窗口内显示多个页面。每个页面都是单独的QWidget，可以在其中添加其他控件。

QTabWidget支持多种选项卡位置、选项卡形状，以及选项卡顺序可编辑等。同时，它还提供了一些与选项卡和页面相关的信号和槽函数，可以在程序中实现动态切换、关闭、添加、移动和重命名选项卡和页面等功能。

二、使用方法

使用QTabWidget需要在Qt项目中引入QtWidgets模块。首先，在UI设计器中将QTabWidget拖入窗口，或者在代码中创建QTabWidget对象：

#include <QtWidgets/QTabWidget>

QTabWidget *tabWidget = new QTabWidget(parent);

然后，在QTabWidget中添加页面，每个页面都需要单独创建一个QWidget，并添加到QTabWidget中：

QWidget *page1 = new QWidget();
QWidget *page2 = new QWidget();
QWidget *page3 = new QWidget();

tabWidget->addTab(page1, tr("Page 1"));
tabWidget->addTab(page2, tr("Page 2"));
tabWidget->addTab(page3, tr("Page 3"));

上述代码创建了三个QWidget对象作为QTabWidget的子页面，并设置了它们的标签名称。在使用addTab()函数添加子页面时，需要指定页面的指针和标签名称。

三、常用属性和方法

1. 属性

（1）tabBarPosition：选项卡位置

选项卡位置可以设置为四个方向：North(默认)、South、West和East。可以使用setTabBarPosition()函数进行设置。

tabWidget->setTabBarPosition(QTabWidget::South);

（2）tabShape：选项卡形状

默认为Rounded形状，可选的形状还包括Square和Triangular。可以使用setTabShape()进行设置。

tabWidget->setTabShape(QTabWidget::Triangular);

（3）tabsClosable：选项卡是否可关闭

默认为false，可以使用setTabsClosable()进行设置。

tabWidget->setTabsClosable(true);

（4）currentIndex：当前选项卡索引

初始值为0，可以使用setCurrentIndex()函数进行设置。

tabWidget->setCurrentIndex(1);

2. 方法

（1）addTab(QWidget *page, const QString &label)：添加选项卡。

QWidget *newPage = new QWidget();
tabWidget->addTab(newPage, tr("New Page"));

（2）insertTab(int index, QWidget *page, const QString &label)：在指定位置插入选项卡。

QWidget *newPage = new QWidget();
int index = 2;
tabWidget->insertTab(index, newPage, tr("New Page"));

（3）removeTab(int index)：删除指定索引的选项卡。

int index = 1;
tabWidget->removeTab(index);

（4）clear()：删除所有选项卡。

tabWidget->clear();

（5）tabText(int index)：返回指定索引的选项卡标签名称。

int index = 1;
QString labelText = tabWidget->tabText(index);

（6）setTabText(int index, const QString &label)：设置指定索引的选项卡标签名称。

int index = 1;
tabWidget->setTabText(index, tr("New Label"));

（7）tabToolTip(int index)：返回指定索引的选项卡工具提示信息。

int index = 1;
QString toolTipText = tabWidget->tabToolTip(index);

（8）setTabToolTip(int index, const QString &tip)：设置指定索引的选项卡工具提示信息。

int index = 1;
tabWidget->setTabToolTip(index, tr("New Tip"));

（9）tabWhatsThis(int index)：返回指定索引的选项卡WhatsThis信息。

int index = 1;
QString whatsThisText = tabWidget->tabWhatsThis(index);

（10）setTabWhatsThis(int index, const QString &text)：设置指定索引的选项卡WhatsThis信息。

int index = 1;
tabWidget->setTabWhatsThis(index, tr("New WhatsThis"));

四、响应用户交互

QTabWidget还提供了多个与选项卡相关的信号和槽函数，可以在程序中实现动态切换、关闭、添加、移动和重命名选项卡和页面等交互。

（1）tabBarClicked(int index)：选项卡单击事件响应。

当选项卡被单击时，响应该信号。

connect(tabWidget, SIGNAL(tabBarClicked(int)), this, SLOT(onTabBarClicked(int)));

（2）tabCloseRequested(int index)：选项卡关闭事件响应。

当选项卡关闭按钮被单击时，响应该信号。

connect(tabWidget, SIGNAL(tabCloseRequested(int)), this, SLOT(onTabCloseRequested(int)));

（3）currentChanged(int index)：当前选项卡变化事件响应。

当当前选项卡变化时，响应该信号。

connect(tabWidget, SIGNAL(currentChanged(int)), this, SLOT(onCurrentChanged(int)));

（4）tabMoved(int from, int to)：选项卡移动事件响应。

当选项卡被拖动移动时，响应该信号。

connect(tabWidget, SIGNAL(tabMoved(int, int)), this, SLOT(onTabMoved(int, int)));

（5）tabBarDoubleClicked(int index)：选项卡双击事件响应。

当选项卡被双击时，响应该信号。

connect(tabWidget, SIGNAL(tabBarDoubleClicked(int)), this, SLOT(onTabBarDoubleClicked(int)));

除了上述信号，QTabWidget还提供了多种与选项卡和页面相关的函数，如setTabEnabled()、setTabIcon()、setMovable()、count()等，可以根据实际需求进行调用。

五、总结

Qt QTabWidget是一种方便快捷的界面组件，可以轻松实现多页面的切换和管理。除了基本的添加、删除、重命名选项卡和页面等功能，还可以通过响应选项卡事件，实现更多有趣的功能，如修改选项卡颜色、路径选择器、切换页面时保存工作状态等。希望读者能够学以致用，运用QTabWidget打造出更加功能丰富、用户友好的界面。