对于Qt：QTabWidget常见属性的解析

开篇介绍：

hello 大家，本篇博客我们来学习QTabWidget常见属性。

在 Qt 桌面应用开发中，当我们需要在有限的界面空间内展示多个功能模块时 ------ 比如浏览器的多个网页、IDE 的多个代码编辑页、设置界面的 "基本设置""高级设置""外观设置"------ 如果把所有控件都堆在一个页面上，界面会变得极其拥挤，用户根本找不到自己想要的功能。

这时候，我们就需要一个专门的控件来 "将不同功能模块归类到不同标签页中，通过点击标签切换显示"------ 这个控件就是 QTabWidget（标签页控件）。

QTabWidget 就像 "我们平时用的浏览器的标签栏"------ 它是一个带标签的多页面容器，每个标签页对应一个独立的功能页面（QWidget）；你可以点击不同的标签切换显示对应的页面；你可以把标签放在上方、下方、左侧、右侧；你可以给标签设置文本、图标、提示信息；你可以让标签显示关闭按钮，让用户可以关闭标签页；你还可以让标签可以拖动，调整顺序。

很多新手刚接触 QTabWidget 时，会觉得它很简单 ------ 不就是几个标签页吗？但其实，QTabWidget 有很多细节值得我们深入学习：比如标签页位置怎么调整、当前索引怎么管理、标签文本 / 图标 / 提示怎么设置、关闭按钮怎么用、拖动顺序怎么实现、各个信号怎么联动等等。掌握了这些细节，你才能用 QTabWidget 做出既实用又美观的多标签页界面。

这篇文章我会结合 Qt 官方文档和实际开发经验，按照最常用的属性顺序：先讲 QTabWidget 的基础概念 （是什么、为什么用、怎么添加标签页），再逐个讲 QTabWidget 的核心属性 （tabPosition、currentIndex、currentTabText、currentTabName、currentTabIcon、currentTabToolTip、tabsCloseable、movable），然后讲 QTabWidget 的核心交互信号（currentChanged、tabBarClicked、tabBarDoubleClicked、tabCloseRequested），最后是综合示例和全文总结。

话不多说，我们正式开始！

第一章先搞懂基础：QTabWidget 是什么？为什么要用它？

在讲具体属性之前，我们必须先搞懂几个最基础、最重要的问题：QTabWidget 是用来做什么的？为什么要用它？以及，怎么往 QTabWidget 里添加标签页？

1.1 QTabWidget 的核心定位

QTabWidget 是 Qt Widgets 模块中带标签页的多页面容器控件------ 它支持添加多个 QWidget 并通过标签页切换显示，核心作用是在有限的界面空间内，将不同功能模块的 Widget 归类到不同标签页中，通过点击标签切换显示对应的 Widget。

通俗理解：QTabWidget 就是 "一个带标签的文件夹收纳册"------ 收纳册里有多个文件夹（标签页），每个文件夹里装着不同的东西（QWidget 及其内部控件）；你可以通过文件夹的标签（标题）快速切换到不同的文件夹，查看里面的东西；同一时间你只能看到一个文件夹里的内容。

QTabWidget 的核心特征：

多页管理：一个 QTabWidget 可包含多个标签页，每个标签页对应一个独立的 QWidget，同一时间仅显示一个标签页内容；
灵活定制：支持标签页位置、文本、图标、提示信息的自定义配置；
交互增强：支持标签页可关闭（显示 × 按钮）、可拖动移动，提升用户操作体验。

1.2 QTabWidget 和 QGroupBox 的核心区别（必知！）

很多新手刚接触 Qt 时，会把 QTabWidget 和 QGroupBox 搞混 ------ 因为它们都是容器控件。但实际上，它们的使用场景和核心作用完全不一样，必须严格区分！

这里我用一个表格把它们的核心区别列出来，方便大家查阅和记忆：

对比维度	QTabWidget	QGroupBox
核心定位	多页面切换容器	单页面分组容器
界面形态	带标签栏，多个标签页，同一时间显示一个	带标题的框，所有控件在同一页面显示
核心作用	在有限空间内展示多个功能模块，通过标签切换	在同一页面内将功能相关的控件归为一组，美化界面
典型场景	浏览器标签页、IDE 代码编辑页、设置界面的多页设置	表单的 "用户信息" 分组、"系统设置" 分组
子控件数量	每个标签页对应一个 QWidget，QWidget 内部再放子控件	直接通过布局管理多个子控件

通俗理解：

QTabWidget 是 "多页文件夹收纳册"------ 一页一页的，翻页看；
QGroupBox 是 "单页收纳盒"------ 都在一页上，用盒子分开。

1.3 往 QTabWidget 中添加标签页的核心原则（开篇就讲，刻在脑子里！）

在正式讲属性之前，还有一个超级重要、新手最容易踩坑、一踩就无效的注意事项，必须开篇就讲，刻在脑子里：

往 QTabWidget 中添加标签页的核心原则是：先创建 QWidget 对象，给 QWidget 设置布局并添加子控件，最后调用 QTabWidget 的 addTab () 方法将 QWidget 添加为标签页。

QTabWidget 不能直接 addWidget ()，它的基本单元是 "标签页（QWidget）"！

很多新手刚接触 QTabWidget 时，会试图直接用 tabWidget->addWidget(widget) 往里面加控件 ------ 这是完全错误的！QTabWidget 的 addTab() 方法接受的是一个 QWidget（作为一个标签页），而不是单个子控件！

通俗理解：QTabWidget 是 "文件夹收纳册"------ 你不能直接把一张纸（子控件）放进收纳册，你得先把纸放进一个文件夹（QWidget）里，然后把文件夹放进收纳册。

这个注意事项超级重要，虽然这篇文章主要讲属性，但这个是使用 QTabWidget 的基础，必须先记住！后面综合示例里我会再演示怎么用，但现在必须先有这个概念！

第二章 QTabWidget 核心属性详解

好，我们正式开始！按照最常用的顺序，我们逐个讲 QTabWidget 的核心属性：tabPosition、currentIndex、currentTabText、currentTabName、currentTabIcon、currentTabToolTip、tabsCloseable、movable。

注意：其中 currentTabText、currentTabName、currentTabIcon、currentTabToolTip 不是 Qt 官方的直接属性，而是 "常用组合操作的封装"------ 我们需要通过 currentIndex() 加上对应的 tabText()/setTabText()、widget()/setObjectName()、tabIcon()/setTabIcon()、tabToolTip()/setTabToolTip() 来实现，我会在每个属性里详细讲。

2.1 属性一：tabPosition------ 标签页在控件中的显示位置

2.1.1 属性的核心定义

tabPosition 是 QTabWidget 用于控制标签栏（包含所有标签页）相对于内容区域位置 的样式属性 ------ 默认值为 QTabWidget::North（上方），支持四个方向的布局。

通俗理解：tabPosition 就像 "调整文件夹收纳册的标签栏位置"------ 你可以把标签栏放在收纳册的上方、下方、左侧、右侧；默认是在上方，就像浏览器的标签栏一样。

这里有几个超级重要的规则，必须牢记：

视觉适配 ：
- West/East（左右侧）的标签页文本默认垂直显示；
- North/South（上下方）的标签页文本默认水平显示；
布局影响：位置变更会自动调整内容区域的大小，无需手动修改 Widget 尺寸；
动态生效：设置后立即刷新界面，无需额外调用刷新方法。

2.1.2 核心枚举值（QTabWidget::TabPosition）

Qt 为 tabPosition 定义了四个枚举值，分别对应四个方向：

枚举值	功能说明
`QTabWidget::North`	标签页显示在上方（默认值，最常用，类似浏览器）；
`QTabWidget::South`	标签页显示在下方；
`QTabWidget::West`	标签页显示在左侧，文本默认垂直显示；
`QTabWidget::East`	标签页显示在右侧，文本默认垂直显示；

2.1.3 关联 API 详解（逐词逐句，零模糊）

通过两个成员函数设置和获取：

1. 获取当前标签页位置：QTabWidget::TabPosition tabPosition () const

函数原型：

复制代码

QTabWidget::TabPosition QTabWidget::tabPosition() const;

逐词逐句底层解析：

QTabWidget::TabPosition：返回值类型，返回标签页位置的枚举值；
- 是 QTabWidget 类内部定义的枚举类型；
QTabWidget::：说明这个函数是 QTabWidget 类的成员函数；
tabPosition()：函数名，很直观，就是 "获取标签页位置" 的意思；
const：常成员函数，不会修改控件状态。

返回值说明：

返回 QTabWidget::TabPosition 枚举值；
默认值为 QTabWidget::North。

2. 设置标签页位置：void setTabPosition (QTabWidget::TabPosition position)

函数原型：

复制代码

void QTabWidget::setTabPosition(QTabWidget::TabPosition position);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setTabPosition()：函数名，"设置标签页位置" 的意思；
QTabWidget::TabPosition position：入参，标签页位置的枚举值。

参数说明：

position：标签页位置，QTabWidget::TabPosition 枚举类型；
- 可选值：QTabWidget::North、QTabWidget::South、QTabWidget::West、QTabWidget::East。

2.1.4 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例1：创建 TabWidget 并设置标签页在左侧（West）
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);
tabWidget->setTabPosition(QTabWidget::West); // 标签页显示在左侧，文本垂直

// 添加两个标签页（演示用）
QWidget* tab1 = new QWidget();
tabWidget->addTab(tab1, "标签页 1");
QWidget* tab2 = new QWidget();
tabWidget->addTab(tab2, "标签页 2");

// 示例2：获取当前标签页位置并打印
QTabWidget::TabPosition currentPos = tabWidget->tabPosition();
QString posStr;
switch (currentPos) {
    case QTabWidget::North: posStr = "上方"; break;
    case QTabWidget::South: posStr = "下方"; break;
    case QTabWidget::West:  posStr = "左侧"; break;
    case QTabWidget::East:  posStr = "右侧"; break;
}
qDebug() << "当前标签页位置：" << posStr; // 输出："左侧"

2.1.5 关键注意事项（必知！）

左右侧标签页文本默认垂直显示！（超级重要！） ：
- 如果你设置 tabPosition 为 West 或 East；
- 标签页的文本会默认垂直显示（竖着写）；
- 如果你想让文本水平显示，需要用 Qt Style Sheets (QSS) 来定制，后面学习建议里会提到；
布局自动调整！（超级重要！） ：
- 改变 tabPosition 后，QTabWidget 会自动调整内容区域的大小和位置；
- 不需要你手动修改内部 QWidget 的尺寸；
- 非常方便！
动态生效！ ：
- 调用 setTabPosition() 后，界面会立即刷新；
- 不需要调用 update() 或 repaint() 等额外的刷新方法；
默认值是 North！ ：
- 如果你不调用 setTabPosition()，标签页默认显示在上方；
- 这是最常用的位置，类似浏览器、IDE 等软件的标签栏位置。

2.2 属性二：currentIndex------ 当前选中标签页的索引（从 0 开始计算）

2.2.1 属性的核心定义

currentIndex 是 QTabWidget 最核心、最常用的状态属性 ------ 它标识当前激活显示的标签页位置，无任何标签页时返回 -1，是切换和查询标签页状态的核心属性。

通俗理解：currentIndex 就像 "文件夹收纳册当前翻开的是第几页"------ 页码从 0 开始，第 1 个标签页索引是 0，第 2 个是 1，以此类推；如果收纳册里没有文件夹，就返回 -1。

这里有几个超级重要的规则，必须牢记，刻在脑子里：

索引规则（超级重要！开篇就讲！） ：
- 索引从 0 开始！
- 第一个标签页索引为 0，第二个为 1，依次递增；
越界处理（超级重要！） ：
- 设置 index < 0 或 index ≥ tabCount()（标签页总数）时，无任何操作！
- currentIndex 保持不变！
- 不会报错，但也不会生效！
信号联动 ：索引变更会触发 currentChanged(int index) 信号（后面会讲）。

2.2.2 关联 API 详解（逐词逐句，零模糊）

通过两个成员函数设置和获取：

1. 获取当前选中标签页的索引：int currentIndex () const

函数原型：

复制代码

int QTabWidget::currentIndex() const;

逐词逐句底层解析：

int：返回值类型，返回当前选中标签页的索引；
QTabWidget::：成员函数；
currentIndex()：函数名，"获取当前索引" 的意思；
const：常成员函数。

返回值说明：

返回 int 类型的整数；
有选中标签页 → 返回当前选中标签页的索引（从 0 开始）；
无任何标签页 → 返回 -1。

2. 设置选中指定索引的标签页：void setCurrentIndex (int index)

函数原型：

复制代码

void QTabWidget::setCurrentIndex(int index);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setCurrentIndex()：函数名，"设置当前索引" 的意思；
int index：入参，要选中的标签页索引。

参数说明：

index：要选中的标签页索引，int 类型；
- 有效范围：0 ≤ index < tabCount()（tabCount() 是标签页总数，后面会提到）；
- 越界时（index < 0 或 index ≥ tabCount()），无任何操作。

2.2.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：创建两个标签页，默认选中第二个（索引 1）
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 添加第一个标签页（索引 0）
QWidget* tab1 = new QWidget();
tabWidget->addTab(tab1, "标签页 1");

// 添加第二个标签页（索引 1）
QWidget* tab2 = new QWidget();
tabWidget->addTab(tab2, "标签页 2");

// 【关键！】设置选中第二个标签页（索引 1）
tabWidget->setCurrentIndex(1);

// 打印当前选中索引
qDebug() << "当前选中索引：" << tabWidget->currentIndex(); // 输出：1

// 示例：越界测试（设置索引 2，无效，currentIndex 保持 1）
tabWidget->setCurrentIndex(2);
qDebug() << "越界设置后当前索引：" << tabWidget->currentIndex(); // 输出：1

2.2.4 关键注意事项（必知！）

索引从 0 开始！（超级重要！说三遍！） ：
- 这是 Qt 控件的通用规则！
- 第一个标签页永远是索引 0，不是 1！
- 千万不要搞反！
越界无操作！（超级重要！） ：
- 如果你设置的索引小于 0，或者大于等于标签页总数；
- QTabWidget 不会报错，但也不会执行任何操作！
- currentIndex 会保持原来的值不变！
- 所以在设置之前，最好先判断一下索引是否有效！
信号联动！（超级重要！） ：
- 调用 setCurrentIndex() 会触发 currentChanged(int index) 信号！
- 如果你在 currentChanged 的槽函数里有业务逻辑（比如加载数据）；
- 调用 setCurrentIndex() 也会执行这些逻辑！
- 如果你想避免这种情况，可以先断开信号连接，设置完再重新连接！
无标签页时返回 -1！ ：
- 如果 QTabWidget 里没有任何标签页；
- currentIndex() 返回 -1；
- 在使用 currentIndex() 之前，最好先判断一下返回值是否 ≥ 0！

2.3 属性三：currentTabText------ 当前选中标签页的显示文本

2.3.1 属性的核心定义

首先说明：currentTabText 不是 Qt 官方的直接属性，而是 "常用组合操作的封装"------ 它表示当前激活标签页的标题文本，需通过 currentIndex() + tabText() 组合获取，通过 currentIndex() + setTabText() 组合设置，是标签页标识的核心内容。

通俗理解：currentTabText 就像 "文件夹收纳册当前翻开的文件夹的标签名"------ 你可以查看这个标签名，也可以修改这个标签名。

这里有几个超级重要的规则，必须牢记：

生效前提 ：currentIndex() ≥ 0（存在选中标签页），否则设置 / 获取无意义；
文本支持 ：支持中文、特殊字符，不支持 HTML 富文本（这点和 QLabel 不一样，要注意！）；
显示适配：文本过长时会自动截断并显示省略号（...）。

2.3.2 关联 API 详解（逐词逐句，零模糊）

我们需要用到四个 API：tabText()（获取指定索引标签页的文本）、setTabText()（设置指定索引标签页的文本），以及之前讲的 currentIndex()。

1. 获取指定索引标签页的文本：QString tabText (int index) const

函数原型：

复制代码

QString QTabWidget::tabText(int index) const;

逐词逐句底层解析：

QString：返回值类型，返回指定索引标签页的文本；
QTabWidget::：成员函数；
tabText()：函数名，"获取标签文本" 的意思；
int index：入参，标签页的索引；
const：常成员函数。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()。

返回值说明：

返回 QString 类型的文本；
索引有效 → 返回对应标签页的文本；
索引无效 → 返回空字符串（""）。

2. 设置指定索引标签页的文本：void setTabText (int index, const QString& text)

函数原型：

复制代码

void QTabWidget::setTabText(int index, const QString& text);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setTabText()：函数名，"设置标签文本" 的意思；
int index：入参，标签页的索引；
const QString& text：入参，要设置的文本；
- const：常量修饰；
- QString&：引用传递，避免拷贝。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()；
- 索引无效时，无任何操作；
text：要设置的文本，QString 类型；
- 支持中文、特殊字符；
- 不支持 HTML 富文本。

3. 组合操作：获取 / 设置当前标签页的文本

获取当前标签页文本：tabWidget->tabText(tabWidget->currentIndex())；
设置当前标签页文本：tabWidget->setTabText(tabWidget->currentIndex(), "新文本")。

2.3.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：获取并修改当前选中标签页的文本
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 添加一个标签页（索引 0，默认选中）
QWidget* tab1 = new QWidget();
tabWidget->addTab(tab1, "初始文本");

// 1. 获取当前标签页文本
int curIndex = tabWidget->currentIndex();
if (curIndex >= 0) { // 【必须！】先判断索引有效！
    QString curText = tabWidget->tabText(curIndex);
    qDebug() << "当前标签文本：" << curText; // 输出："初始文本"
}

// 2. 修改当前标签页文本
if (curIndex >= 0) {
    tabWidget->setTabText(curIndex, "修改后的文本");
    qDebug() << "修改后标签文本：" << tabWidget->tabText(curIndex); // 输出："修改后的文本"
}

2.3.4 关键注意事项（必知！）

生效前提：currentIndex () ≥ 0！（超级重要！说三遍！） ：
- 如果没有选中的标签页（currentIndex() == -1）；
- 获取或设置当前标签页文本都是没有意义的！
- 必须先判断 currentIndex() ≥ 0，再调用 tabText() 或 setTabText()！
不支持 HTML 富文本！（超级重要！） ：
- 这点和 QLabel、QPushButton 不一样！
- 如果你试图用 setTabText(index, "<b>加粗文本</b>") 来让标签文本加粗；
- 它不会生效，只会原样显示 <b>加粗文本</b>！
- 如果想美化标签文本，需要用 Qt Style Sheets (QSS)；
文本过长自动截断！（超级重要！） ：
- 如果标签文本太长，超过了标签栏的显示宽度；
- QTabWidget 会自动截断文本，并在末尾显示省略号（...）；
- 你可以通过调整 QTabWidget 的宽度，或者用 QSS 调整标签栏的宽度来显示更多文本；
索引无效时无操作！ ：
- 如果你调用 setTabText() 时传入的索引无效；
- QTabWidget 不会报错，但也不会执行任何操作！

2.4.1 属性的核心定义

同样说明：currentTabName 不是 Qt 官方的直接属性，而是 "常用操作的封装"------ 标签页本身无独立 "名字" 属性，通常将标签页对应的 QWidget 的 objectName 作为标签页的标识名，用于逻辑区分不同标签页。

通俗理解：currentTabName 就像 "文件夹收纳册当前翻开的文件夹的内部编号"------ 这个编号是给程序看的，不是给用户看的；用户看的是标签文本（tabText），程序逻辑判断用的是 objectName。

这里有几个超级重要的规则，必须牢记：

生效前提 ：currentIndex() ≥ 0 且 widget(currentIndex()) 不为 nullptr；
命名规范 ：建议设置有业务含义的名字（如 "userInfoTab"、"settingTab"），便于逻辑判断；
唯一性 ：不同标签页的 QWidget 建议设置唯一的 objectName，避免混淆。

2.4.2 关联 API 详解（逐词逐句，零模糊）

我们需要用到三个 API：widget()（获取指定索引标签页对应的 QWidget）、objectName()（获取 QWidget 的对象名）、setObjectName()（设置 QWidget 的对象名），以及 currentIndex()。

函数原型：

复制代码

QWidget* QTabWidget::widget(int index) const;

逐词逐句底层解析：

QWidget*：返回值类型，返回指定索引标签页对应的 QWidget 指针；
QTabWidget::：成员函数；
widget()：函数名，"获取标签页 Widget" 的意思；
int index：入参，标签页的索引；
const：常成员函数。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()。

返回值说明：

返回 QWidget* 类型的指针；
索引有效 → 返回对应标签页的 QWidget 指针；
索引无效 → 返回 nullptr；
必须先判空再操作！

获取当前标签页 Widget 的对象名：

复制代码

QWidget* curWidget = tabWidget->widget(tabWidget->currentIndex());
if (curWidget != nullptr) {
    QString curName = curWidget->objectName();
}

设置当前标签页 Widget 的对象名：

复制代码

QWidget* curWidget = tabWidget->widget(tabWidget->currentIndex());
if (curWidget != nullptr) {
    curWidget->setObjectName("newName");
}

2.4.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：为标签页 Widget 设置名字并获取
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 创建第一个标签页 Widget，并设置对象名
QWidget* userInfoTab = new QWidget();
userInfoTab->setObjectName("userInfoTab"); // 【关键！】设置 Widget 名字（给程序看的）
tabWidget->addTab(userInfoTab, "用户信息"); // 标签文本（给用户看的）

// 获取当前标签页 Widget 的对象名
int curIndex = tabWidget->currentIndex();
if (curIndex >= 0) {
    QWidget* curWidget = tabWidget->widget(curIndex);
    if (curWidget != nullptr) { // 【必须！】判空！
        QString curName = curWidget->objectName();
        qDebug() << "当前标签页 Widget 名字：" << curName; // 输出："userInfoTab"
        
        // 【典型用法】根据名字判断标签页类型，执行不同逻辑
        if (curName == "userInfoTab") {
            qDebug() << "这是用户信息标签页，执行用户信息相关逻辑...";
        }
    }
}

2.4.4 关键注意事项（必知！）

生效前提：currentIndex () ≥ 0 且 widget () 不为 nullptr！（超级重要！说三遍！） ：
- 必须先判断 currentIndex() ≥ 0；
- 再判断 widget(index) != nullptr；
- 最后才能调用 objectName() 或 setObjectName()！
- 否则会导致程序崩溃！
命名规范！（超级重要！） ：
- 建议给标签页的 QWidget 设置有业务含义的 objectName；
- 比如 "userInfoTab"（用户信息标签页）、"settingTab"（设置标签页）、"homeTab"（首页标签页）；
- 这样在代码里你可以通过 objectName() 判断当前是哪个标签页，执行不同的业务逻辑；
- 非常方便！
唯一性！（超级重要！） ：
- 不同标签页的 QWidget 建议设置唯一的 objectName；
- 避免混淆；
- 虽然 Qt 允许重复的 objectName，但在 QTabWidget 这种场景下，唯一的名字更利于逻辑判断；
区分 tabText 和 objectName！（超级重要！） ：
- tabText 是给用户看的，显示在标签栏上；
- objectName 是给程序看的，用于逻辑判断；
- 它们可以一样，也可以不一样；
- 建议 tabText 用友好的中文（如 "用户信息"），objectName 用英文标识符（如 "userInfoTab"）。

2.5 属性五：currentTabIcon------ 当前选中标签页的显示图标

2.5.1 属性的核心定义

同样说明：currentTabIcon 不是 Qt 官方的直接属性，而是 "常用组合操作的封装"------ 它表示当前激活标签页左侧显示的图标，需通过 currentIndex() + tabIcon() 组合获取，通过 currentIndex() + setTabIcon() 组合设置，用于增强标签页的视觉辨识度。

通俗理解：currentTabIcon 就像 "文件夹收纳册当前翻开的文件夹的标签图标"------ 你可以给不同的文件夹贴不同的图标（比如用户信息贴个人形图标，设置贴个齿轮图标），让用户一眼就能看出这个标签页是做什么的。

这里有几个超级重要的规则，必须牢记：

生效前提 ：currentIndex() ≥ 0，否则设置 / 获取无意义；
图标尺寸 ：图标显示尺寸由 QTabWidget 的 iconSize 属性控制（通过 setIconSize(QSize) 设置）；
资源路径 ：使用资源文件时路径以 :/ 开头，本地图片需传入完整路径。

2.5.2 关联 API 详解（逐词逐句，零模糊）

我们需要用到四个 API：tabIcon()（获取指定索引标签页的图标）、setTabIcon()（设置指定索引标签页的图标）、setIconSize()（设置图标显示尺寸），以及 currentIndex()。

1. 获取指定索引标签页的图标：QIcon tabIcon (int index) const

函数原型：

复制代码

QIcon QTabWidget::tabIcon(int index) const;

逐词逐句底层解析：

QIcon：返回值类型，返回指定索引标签页的图标；
QTabWidget::：成员函数；
tabIcon()：函数名，"获取标签图标" 的意思；
int index：入参，标签页的索引；
const：常成员函数。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()。

返回值说明：

返回 QIcon 类型的图标；
索引有效 → 返回对应标签页的图标；
索引无效或未设置图标 → 返回空的 QIcon。

2. 设置指定索引标签页的图标：void setTabIcon (int index, const QIcon& icon)

函数原型：

复制代码

void QTabWidget::setTabIcon(int index, const QIcon& icon);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setTabIcon()：函数名，"设置标签图标" 的意思；
int index：入参，标签页的索引；
const QIcon& icon：入参，要设置的图标；
- const：常量修饰；
- QIcon&：引用传递，避免拷贝。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()；
- 索引无效时，无任何操作；
icon：要设置的图标，QIcon 类型。

3. 设置图标显示尺寸：void setIconSize (const QSize& size)

函数原型：

复制代码

void QTabWidget::setIconSize(const QSize& size);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setIconSize()：函数名，"设置图标尺寸" 的意思；
const QSize& size：入参，图标显示尺寸；
- QSize 包含宽度和高度，单位是像素。

参数说明：

size：图标显示尺寸，QSize 类型；
- 比如 QSize(20, 20) 表示 20x20 像素。

4. 组合操作：获取 / 设置当前标签页的图标

获取当前标签页图标：tabWidget->tabIcon(tabWidget->currentIndex())；
设置当前标签页图标：tabWidget->setTabIcon(tabWidget->currentIndex(), icon)。

2.5.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QIcon>
#include <QSize>
#include <QDebug>
#include <QApplication>
#include <QStyle>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：为当前标签页设置系统图标
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 【必须！】第一步：先设置全局图标显示尺寸（所有标签页共用！）
tabWidget->setIconSize(QSize(20, 20)); // 图标显示为 20x20 像素

// 添加一个标签页（索引 0，默认选中）
QWidget* settingTab = new QWidget();
tabWidget->addTab(settingTab, "设置");

// 第二步：为当前标签页设置图标（使用系统文件夹图标演示）
int curIndex = tabWidget->currentIndex();
if (curIndex >= 0) {
    // 获取系统文件夹图标（仅作演示，实际可用资源文件）
    QIcon settingIcon = QApplication::style()->standardIcon(QStyle::SP_DirIcon);
    // 设置图标
    tabWidget->setTabIcon(curIndex, settingIcon);
    qDebug() << "已为当前标签页设置图标";
}

2.5.4 关键注意事项（必知！）

生效前提：currentIndex () ≥ 0！（超级重要！说三遍！） ：
- 和之前的属性一样，必须先判断索引有效！
图标尺寸由 setIconSize () 全局控制！（超级重要！说三遍！） ：
- 这点和 QTreeWidget 一样！
- 所有标签页的图标显示尺寸都是一样的！
- 单个标签页无法单独设置图标显示尺寸！
- 必须通过 tabWidget->setIconSize(QSize(width, height)) 统一设置！
资源路径！（超级重要！） ：
- 如果你使用 Qt 资源文件（.qrc）中的图片；
- 路径必须以 :/ 开头，比如 :/images/setting.png；
- 如果你使用本地图片；
- 必须传入完整的绝对路径或相对路径；
索引无效时无操作！ ：
- 调用 setTabIcon() 时索引无效，无任何操作！

2.6 属性六：currentTabToolTip------ 当前选中标签页的鼠标悬浮提示信息

2.6.1 属性的核心定义

同样说明：currentTabToolTip 不是 Qt 官方的直接属性，而是 "常用组合操作的封装"------ 它表示鼠标悬浮在当前标签页上时显示的提示文本，需通过 currentIndex() + tabToolTip() 组合获取，通过 currentIndex() + setTabToolTip() 组合设置，用于提升用户体验。

通俗理解：currentTabToolTip 就像 "文件夹收纳册当前翻开的文件夹的标签提示"------ 当你把鼠标悬停在标签上时，会弹出一个小提示，告诉你这个标签页是做什么的，或者有什么注意事项。

这里有几个超级重要的规则，必须牢记：

生效前提 ：currentIndex() ≥ 0，否则设置 / 获取无意义；
文本长度：支持较长文本，悬浮时自动换行显示；
触发条件：鼠标悬浮在标签页文本 / 图标区域时显示，离开后消失。

2.6.2 关联 API 详解（逐词逐句，零模糊）

我们需要用到四个 API：tabToolTip()（获取指定索引标签页的提示）、setTabToolTip()（设置指定索引标签页的提示），以及 currentIndex()。

1. 获取指定索引标签页的提示信息：QString tabToolTip (int index) const

函数原型：

复制代码

QString QTabWidget::tabToolTip(int index) const;

逐词逐句底层解析：

QString：返回值类型，返回指定索引标签页的提示信息；
QTabWidget::：成员函数；
tabToolTip()：函数名，"获取标签提示" 的意思；
int index：入参，标签页的索引；
const：常成员函数。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()。

返回值说明：

返回 QString 类型的文本；
索引有效 → 返回对应标签页的提示信息；
索引无效或未设置提示 → 返回空字符串（""）。

2. 设置指定索引标签页的提示信息：void setTabToolTip (int index, const QString& tip)

函数原型：

复制代码

void QTabWidget::setTabToolTip(int index, const QString& tip);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setTabToolTip()：函数名，"设置标签提示" 的意思；
int index：入参，标签页的索引；
const QString& tip：入参，要设置的提示信息。

参数说明：

index：标签页的索引，int 类型；
- 有效范围：0 ≤ index < tabCount()；
- 索引无效时，无任何操作；
tip：要设置的提示信息，QString 类型；
- 支持较长文本，支持换行（\n）。

3. 组合操作：获取 / 设置当前标签页的提示信息

获取当前标签页提示：tabWidget->tabToolTip(tabWidget->currentIndex())；
设置当前标签页提示：tabWidget->setTabToolTip(tabWidget->currentIndex(), "提示信息")。

2.6.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：为当前标签页设置悬浮提示
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 添加一个标签页（索引 0，默认选中）
QWidget* userInfoTab = new QWidget();
tabWidget->addTab(userInfoTab, "用户信息");

// 为当前标签页设置提示信息
int curIndex = tabWidget->currentIndex();
if (curIndex >= 0) {
    // 设置提示信息（支持换行 \n）
    tabWidget->setTabToolTip(curIndex, "查看/编辑用户基本信息\n包括姓名、年龄、性别等");
    // 获取提示信息并打印
    QString curTip = tabWidget->tabToolTip(curIndex);
    qDebug() << "当前标签提示：" << curTip;
    // 输出："查看/编辑用户基本信息\n包括姓名、年龄、性别等"
}

2.6.4 关键注意事项（必知！）

生效前提：currentIndex () ≥ 0！（超级重要！说三遍！）；
支持较长文本和换行！（超级重要！） ：
- 提示信息可以写得比较长；
- 支持用 \n 换行；
- 悬浮时会自动换行显示，非常方便；
触发条件！（超级重要！） ：
- 只有当鼠标悬浮在标签页的文本或图标区域时，提示信息才会显示；
- 鼠标离开后，提示信息会自动消失；
- 悬浮在内容区域（标签页对应的 QWidget 区域）不会触发；
索引无效时无操作！。

2.7 属性七：tabsCloseable------ 所有标签页是否显示关闭按钮（×）

2.7.1 属性的核心定义

tabsCloseable 是 QTabWidget 用于 ** 控制所有标签页是否在右侧显示关闭按钮（×）** 的交互属性 ------ 默认值为 false（不显示关闭按钮，用户无法通过界面关闭标签页）；设为 true 时，每个标签页右侧会显示一个关闭按钮。

通俗理解：tabsCloseable 就像 "文件夹收纳册的每个文件夹标签上要不要加个 × 按钮"------ 加了之后，用户可以点击 × 按钮把文件夹拿掉（关闭标签页）；不加的话，用户就拿不掉。

这里有几个超级重要的规则，必须牢记，刻在脑子里：

信号联动！（超级重要！说三遍！） ：
- 点击关闭按钮不会自动删除标签页！
- 只会触发 tabCloseRequested(int index) 信号！
- 你必须手动在这个信号的槽函数里调用 removeTab(index) 才能真正关闭标签页！
全局生效！（超级重要！） ：
- 设置后所有标签页均显示 / 隐藏关闭按钮！
- 无法单独控制某一个标签页显示 / 隐藏关闭按钮！
视觉适配：关闭按钮显示在标签页文本右侧，不影响文本 / 图标显示。

2.7.2 关联 API 详解（逐词逐句，零模糊）

通过两个成员函数设置和获取：

1. 判断是否显示关闭按钮：bool tabsCloseable () const

函数原型：

复制代码

bool QTabWidget::tabsCloseable() const;

逐词逐句底层解析：

bool：返回值类型，true 表示显示关闭按钮，false 表示不显示；
QTabWidget::：成员函数；
tabsCloseable()：函数名，"标签是否可关闭" 的意思；
const：常成员函数。

返回值说明：

返回 bool 类型；
true：显示关闭按钮；
false：不显示关闭按钮（默认）。

2. 设置是否显示关闭按钮：void setTabsCloseable (bool closeable)

函数原型：

复制代码

void QTabWidget::setTabsCloseable(bool closeable);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setTabsCloseable()：函数名，"设置标签是否可关闭" 的意思；
bool closeable：入参，true 表示显示关闭按钮，false 表示隐藏。

参数说明：

closeable：是否显示关闭按钮，bool 类型；
- true：所有标签页显示关闭按钮；
- false：所有标签页隐藏关闭按钮（默认）。

2.7.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：启用标签页关闭按钮
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 【关键！】启用标签页关闭按钮（所有标签页显示×）
tabWidget->setTabsCloseable(true);

// 添加两个标签页
QWidget* tab1 = new QWidget();
tabWidget->addTab(tab1, "可关闭标签 1");
QWidget* tab2 = new QWidget();
tabWidget->addTab(tab2, "可关闭标签 2");

// 打印是否显示关闭按钮
qDebug() << "是否显示关闭按钮：" << tabWidget->tabsCloseable(); // 输出：true

2.7.4 关键注意事项（必知！）

点击关闭按钮不会自动删除标签页！（超级重要！说三遍！） ：
- 这是最最最容易踩的坑！
- 很多新手以为设置了 setTabsCloseable(true)，用户点击 × 就会自动关闭标签页；
- 大错特错！
- 点击 × 只会触发 tabCloseRequested(int index) 信号！
- 你必须手动在这个信号的槽函数里调用 removeTab(index) 才能真正关闭标签页！
- 后面讲信号的时候会详细演示！
全局生效！（超级重要！） ：
- setTabsCloseable() 是针对所有标签页的！
- 要么所有标签页都显示关闭按钮，要么都不显示！
- 无法单独控制某一个标签页显示 / 隐藏！
- 如果你想让某个标签页不显示关闭按钮，需要自定义 QTabBar，比较复杂，超出了基础内容的范围；
默认值是 false！ ：
- 如果你不调用 setTabsCloseable()，标签页默认不显示关闭按钮；
- 用户无法通过界面关闭标签页；
视觉适配！ ：
- 关闭按钮显示在标签页文本的右侧；
- 不会影响文本和图标的显示；
- 文本过长时，文本会先截断，再显示关闭按钮。

2.8 属性八：movable------ 标签页是否可通过鼠标拖动调整顺序

2.8.1 属性的核心定义

movable 是 QTabWidget 用于控制标签页是否可通过鼠标拖动调整显示顺序 的交互属性 ------ 默认值为 false（标签页顺序固定，不可拖动）；设为 true 时，用户可按住标签页拖动到任意位置，调整标签页的显示顺序。

通俗理解：movable 就像 "文件夹收纳册的文件夹标签能不能拖动调换位置"------ 可以拖动的话，用户可以把常用的文件夹拖到前面，不常用的拖到后面；不能拖动的话，顺序就是固定的。

这里有几个超级重要的规则，必须牢记：

拖动范围：仅可在标签栏内拖动，无法拖出标签栏；
顺序联动 ：拖动后标签页的 index 会同步变更，但 currentIndex 不会自动变更；
生效范围：全局生效，所有标签页均支持拖动，无法单独控制某一个。

2.8.2 关联 API 详解（逐词逐句，零模糊）

通过两个成员函数设置和获取：

1. 判断标签页是否可移动：bool isMovable () const

函数原型：

复制代码

bool QTabWidget::isMovable() const;

逐词逐句底层解析：

bool：返回值类型，true 表示可移动，false 表示不可移动；
QTabWidget::：成员函数；
isMovable()：函数名，"是否可移动" 的意思；
const：常成员函数。

返回值说明：

返回 bool 类型；
true：标签页可拖动调整顺序；
false：标签页顺序固定（默认）。

2. 设置是否可移动：void setMovable (bool movable)

函数原型：

复制代码

void QTabWidget::setMovable(bool movable);

逐词逐句底层解析：

void：无返回值；
QTabWidget::：成员函数；
setMovable()：函数名，"设置是否可移动" 的意思；
bool movable：入参，true 表示可移动，false 表示不可移动。

参数说明：

movable：是否可拖动调整顺序，bool 类型；
- true：所有标签页可拖动调整顺序；
- false：所有标签页顺序固定（默认）。

2.8.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>

// 假设在 Widget 类的构造函数中，this 是父窗口
// 示例：启用标签页可移动特性
QTabWidget* tabWidget = new QTabWidget(this);
tabWidget->setGeometry(50, 50, 400, 300);

// 【关键！】启用标签页可移动（用户可拖动调整顺序）
tabWidget->setMovable(true);

// 添加多个标签页
QWidget* tab1 = new QWidget();
tabWidget->addTab(tab1, "标签 1");
QWidget* tab2 = new QWidget();
tabWidget->addTab(tab2, "标签 2");
QWidget* tab3 = new QWidget();
tabWidget->addTab(tab3, "标签 3");

// 打印是否可移动
qDebug() << "标签页是否可移动：" << tabWidget->isMovable(); // 输出：true

2.8.4 关键注意事项（必知！）

仅可在标签栏内拖动！（超级重要！） ：
- 用户只能在标签栏的范围内拖动标签页；
- 无法把标签页拖出标签栏（比如拖成独立窗口）；
- 如果想实现拖出成独立窗口，需要自定义 QTabWidget，比较复杂；
拖动后 index 同步变更！（超级重要！） ：
- 用户拖动标签页调整顺序后；
- 标签页的 index 会自动同步变更；
- 比如原来索引 0 的标签页被拖到索引 2 的位置；
- 它的 index 就会变成 2；
- 原来索引 1、2 的标签页会自动前移；
currentIndex 不会自动变更！（超级重要！） ：
- 拖动标签页调整顺序后；
- currentIndex（当前选中标签页的索引）不会自动变更；
- 比如原来选中的是索引 0 的标签页；
- 把它拖到索引 2 的位置后；
- currentIndex 会变成 2（因为它现在在索引 2 的位置，并且仍然是选中状态）；
- 这点是符合预期的；
全局生效！（超级重要！） ：
- setMovable() 是针对所有标签页的！
- 要么所有标签页都可拖动，要么都不可拖动！
- 无法单独控制某一个标签页可拖动！
默认值是 false！ ：
- 如果你不调用 setMovable()，标签页默认顺序固定，不可拖动。

示例代码：

cpp 复制代码

#include "widget.h"
#include "ui_widget.h"
#include <QTabWidget>

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

    //OK大家，接下来我们来学习一下QTabWidget控件
    //这个控件其实也是相当于是一个容器，只不过他是像标签页一样的
    //这个我们肯定不陌生，浏览器中的标签页，那是最多的了~~~
    //那么这个就是像浏览器的标签页一样，每一个标签页里面都可以包含着各种组件
    //但是要注意的是，这个也是想QGroupBox一样，不能直接添加控件进去
    //而是先布局，然后加入~~~

    //比如先创建一个QWidget对象，然后再调用QTabWidget控件的addTab方法进行添加标签页~~

    //下面是他的属性：
    /**
     * @class QTabWidget
     * @brief Qt中带标签页的多页面容器控件，支持添加多个Widget并通过标签页切换显示
     * @details QTabWidget核心作用是在有限的界面空间内，将不同功能模块的Widget归类到不同标签页中，通过点击标签切换显示对应的Widget；
     *          支持自定义标签页的位置、文本、图标、提示信息，还可配置标签页的可关闭、可移动特性，是界面模块化布局的核心控件之一。
     *
     * 【核心特征】
     * 1. 多页管理：一个QTabWidget可包含多个标签页，每个标签页对应一个独立的Widget，同一时间仅显示一个标签页内容；
     * 2. 灵活定制：支持标签页位置、文本、图标、提示信息的自定义配置；
     * 3. 交互增强：支持标签页可关闭（显示×按钮）、可拖动移动，提升用户操作体验。
     */

    // ============================== 核心属性详解 ==============================

    /**
     * @property QTabWidget::tabPosition
     * @brief 标签页在控件中的显示位置
     * @details 控制标签栏（包含所有标签页）相对于内容区域的位置，默认值为QTabWidget::North（上方），支持四个方向的布局。
     *
     * 【核心枚举值（QTabWidget::TabPosition）】
     * | 枚举值   | 功能说明       |
     * |----------|----------------|
     * | North    | 标签页显示在上方 |
     * | South    | 标签页显示在下方 |
     * | West     | 标签页显示在左侧 |
     * | East     | 标签页显示在右侧 |
     *
     * 【关联API详解】
     * 1. QTabWidget::TabPosition tabPosition() const → 获取当前标签页位置；
     * 2. void setTabPosition(QTabWidget::TabPosition position) → 设置标签页位置。
     *
     * @使用示例：
     * // 创建TabWidget并设置标签页在左侧
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->setTabPosition(QTabWidget::West); // 标签页显示在左侧
     * tabWidget->resize(400, 300);
     *
     * 【关键注意事项】
     * 1. 视觉适配：West/East（左右侧）的标签页文本默认垂直显示，North/South（上下方）为水平显示；
     * 2. 布局影响：位置变更会自动调整内容区域的大小，无需手动修改Widget尺寸；
     * 3. 动态生效：设置后立即刷新界面，无需额外调用刷新方法。
     */

    /**
     * @property QTabWidget::currentIndex
     * @brief 当前选中标签页的索引（从0开始计算）
     * @details 标识当前激活显示的标签页位置，无任何标签页时返回-1，是切换和查询标签页状态的核心属性。
     *
     * 【关联API详解】
     * 1. int currentIndex() const → 获取当前选中标签页的索引（无标签页返回-1）；
     * 2. void setCurrentIndex(int index) → 设置选中指定索引的标签页（index超出范围时无操作）。
     *
     * @使用示例：
     * // 创建两个标签页，默认选中第二个（索引1）
     * QTabWidget* tabWidget = new QTabWidget(this);
     * // 添加第一个标签页
     * QWidget* tab1 = new QWidget();
     * tabWidget->addTab(tab1, "标签页1");
     * // 添加第二个标签页
     * QWidget* tab2 = new QWidget();
     * tabWidget->addTab(tab2, "标签页2");
     * // 设置选中第二个标签页
     * tabWidget->setCurrentIndex(1);
     * // 打印当前选中索引
     * qDebug() << "当前选中索引：" << tabWidget->currentIndex(); // 输出：1
     *
     * 【关键注意事项】
     * 1. 索引规则：从0开始，第一个标签页索引为0，依次递增；
     * 2. 越界处理：设置index < 0或≥tabCount()时，无任何操作，currentIndex保持不变；
     * 3. 信号联动：索引变更会触发currentChanged(int index)信号。
     */

    /**
     * @property QTabWidget::currentTabText
     * @brief 当前选中标签页的显示文本（非官方直接属性，为常用组合操作的封装）
     * @details 表示当前激活标签页的标题文本，需通过currentIndex() + tabText()组合获取/设置，是标签页标识的核心内容。
     *
     * 【关联API详解】
     * 1. QString currentTabText() → 等效于tabText(currentIndex())，获取当前标签页文本；
     * 2. void setCurrentTabText(const QString& text) → 等效于setTabText(currentIndex(), text)，设置当前标签页文本；
     * 3. QString tabText(int index) const → 获取指定索引标签页的文本；
     * 4. void setTabText(int index, const QString& text) → 设置指定索引标签页的文本。
     *
     * @使用示例：
     * // 获取并修改当前选中标签页的文本
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->addTab(new QWidget(), "初始文本");
     * // 获取当前文本
     * QString curText = tabWidget->tabText(tabWidget->currentIndex());
     * qDebug() << "当前标签文本：" << curText; // 输出：初始文本
     * // 修改当前文本
     * tabWidget->setTabText(tabWidget->currentIndex(), "修改后的文本");
     *
     * 【关键注意事项】
     * 1. 生效前提：currentIndex() ≥ 0（存在选中标签页），否则设置/获取无意义；
     * 2. 文本支持：支持中文、特殊字符，不支持HTML富文本；
     * 3. 显示适配：文本过长时会自动截断并显示省略号（...）。
     */

    /**
     * @property QTabWidget::currentTabName
     * @brief 当前选中标签页对应的Widget对象名（非官方直接属性，为常用操作封装）
     * @details 标签页本身无独立"名字"属性，通常将标签页对应的Widget的objectName作为标签页的标识名，用于逻辑区分不同标签页。
     *
     * 【关联API详解】
     * 1. QString currentTabName() → 等效于widget(currentIndex())->objectName()，获取当前标签页Widget的名字；
     * 2. void setCurrentTabName(const QString& name) → 等效于widget(currentIndex())->setObjectName(name)，设置名字；
     * 3. QWidget* widget(int index) const → 获取指定索引标签页对应的Widget。
     *
     * @使用示例：
     * // 为标签页Widget设置名字并获取
     * QTabWidget* tabWidget = new QTabWidget(this);
     * QWidget* tab1 = new QWidget();
     * tab1->setObjectName("userInfoTab"); // 设置Widget名字
     * tabWidget->addTab(tab1, "用户信息");
     * // 获取当前标签页名字
     * QString curName = tabWidget->widget(tabWidget->currentIndex())->objectName();
     * qDebug() << "当前标签页名字：" << curName; // 输出：userInfoTab
     *
     * 【关键注意事项】
     * 1. 生效前提：currentIndex() ≥ 0且widget(currentIndex())不为nullptr；
     * 2. 命名规范：建议设置有业务含义的名字（如"settingTab"），便于逻辑判断；
     * 3. 唯一性：不同标签页的Widget建议设置唯一的objectName，避免混淆。
     */

    /**
     * @property QTabWidget::currentTabIcon
     * @brief 当前选中标签页的显示图标（非官方直接属性，为常用组合操作封装）
     * @details 表示当前激活标签页左侧显示的图标，需通过currentIndex() + tabIcon()组合获取/设置，增强标签页的视觉辨识度。
     *
     * 【关联API详解】
     * 1. QIcon currentTabIcon() → 等效于tabIcon(currentIndex())，获取当前标签页图标；
     * 2. void setCurrentTabIcon(const QIcon& icon) → 等效于setTabIcon(currentIndex(), icon)，设置当前标签页图标；
     * 3. QIcon tabIcon(int index) const → 获取指定索引标签页的图标；
     * 4. void setTabIcon(int index, const QIcon& icon) → 设置指定索引标签页的图标。
     *
     * @使用示例：
     * // 为当前标签页设置资源文件图标
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->addTab(new QWidget(), "设置");
     * // 设置图标
     * QIcon icon(":/images/setting.png");
     * tabWidget->setTabIcon(tabWidget->currentIndex(), icon);
     * // 获取图标
     * QIcon curIcon = tabWidget->tabIcon(tabWidget->currentIndex());
     *
     * 【关键注意事项】
     * 1. 生效前提：currentIndex() ≥ 0，否则设置/获取无意义；
     * 2. 图标尺寸：图标显示尺寸由QTabWidget的iconSize属性控制（setIconSize(QSize)）；
     * 3. 资源路径：使用资源文件时路径以:/开头，本地图片需传入完整路径。
     */

    /**
     * @property QTabWidget::currentTabToolTip
     * @brief 当前选中标签页的鼠标悬浮提示信息（非官方直接属性，为常用组合操作封装）
     * @details 鼠标悬浮在当前标签页上时显示的提示文本，需通过currentIndex() + tabToolTip()组合获取/设置，提升用户体验。
     *
     * 【关联API详解】
     * 1. QString currentTabToolTip() → 等效于tabToolTip(currentIndex())，获取当前标签页提示信息；
     * 2. void setCurrentTabToolTip(const QString& tip) → 等效于setTabToolTip(currentIndex(), tip)，设置提示信息；
     * 3. QString tabToolTip(int index) const → 获取指定索引标签页的提示信息；
     * 4. void setTabToolTip(int index, const QString& tip) → 设置指定索引标签页的提示信息。
     *
     * @使用示例：
     * // 为当前标签页设置悬浮提示
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->addTab(new QWidget(), "用户信息");
     * // 设置提示信息
     * tabWidget->setTabToolTip(tabWidget->currentIndex(), "查看/编辑用户基本信息");
     * // 获取提示信息
     * QString curTip = tabWidget->tabToolTip(tabWidget->currentIndex());
     * qDebug() << "当前标签提示：" << curTip; // 输出：查看/编辑用户基本信息
     *
     * 【关键注意事项】
     * 1. 生效前提：currentIndex() ≥ 0，否则设置/获取无意义；
     * 2. 文本长度：支持较长文本，悬浮时自动换行显示；
     * 3. 触发条件：鼠标悬浮在标签页文本/图标区域时显示，离开后消失。
     */

    /**
     * @property QTabWidget::tabsCloseable
     * @brief 所有标签页是否显示关闭按钮（×）
     * @details 设为true时，每个标签页右侧会显示一个关闭按钮；设为false（默认）时无关闭按钮，用户无法通过界面关闭标签页。
     *
     * 【关联API详解】
     * 1. bool tabsCloseable() const → 判断是否显示关闭按钮；
     * 2. void setTabsCloseable(bool closeable) → 设置是否显示（true=显示，false=隐藏）。
     *
     * @使用示例：
     * // 启用标签页关闭按钮
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->setTabsCloseable(true); // 每个标签页显示×按钮
     * // 添加标签页
     * tabWidget->addTab(new QWidget(), "可关闭标签1");
     * tabWidget->addTab(new QWidget(), "可关闭标签2");
     *
     * 【关键注意事项】
     * 1. 信号联动：点击关闭按钮会触发tabCloseRequested(int index)信号，需手动实现关闭逻辑（如removeTab(index)）；
     * 2. 全局生效：设置后所有标签页均显示/隐藏关闭按钮，无法单独控制某一个；
     * 3. 视觉适配：关闭按钮显示在标签页文本右侧，不影响文本/图标显示。
     */

    /**
     * @property QTabWidget::movable
     * @brief 标签页是否可通过鼠标拖动调整顺序
     * @details 设为true时，用户可按住标签页拖动到任意位置，调整标签页的显示顺序；设为false（默认）时标签页顺序固定。
     *
     * 【关联API详解】
     * 1. bool isMovable() const → 判断标签页是否可移动；
     * 2. void setMovable(bool movable) → 设置是否可移动（true=可移动，false=固定）。
     *
     * @使用示例：
     * // 启用标签页可移动特性
     * QTabWidget* tabWidget = new QTabWidget(this);
     * tabWidget->setMovable(true); // 标签页可拖动调整顺序
     * // 添加多个标签页
     * tabWidget->addTab(new QWidget(), "标签1");
     * tabWidget->addTab(new QWidget(), "标签2");
     * tabWidget->addTab(new QWidget(), "标签3");
     *
     * 【关键注意事项】
     * 1. 拖动范围：仅可在标签栏内拖动，无法拖出标签栏；
     * 2. 顺序联动：拖动后标签页的index会同步变更，currentIndex不会自动变更；
     * 3. 生效范围：全局生效，所有标签页均支持拖动，无法单独控制某一个。
     */

    // 创建两个标签页，默认选中第二个（索引1）
     QTabWidget* tabWidget = new QTabWidget(this);

    // 添加第一个标签页
    QWidget* tab1 = new QWidget();
    tabWidget->addTab(tab1, "标签页1");

    // 添加第二个标签页
    QWidget* tab2 = new QWidget();
    tabWidget->addTab(tab2, "标签页2");

    // 设置选中第二个标签页
    tabWidget->setCurrentIndex(1);
}

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

第三章 QTabWidget 核心交互信号详解

讲完了所有核心属性，我们接下来讲 QTabWidget 的核心交互信号------ 这些信号是 QTabWidget 与业务逻辑联动的核心桥梁，覆盖标签页切换、点击、双击、关闭请求等核心操作场景。

按照最常用的顺序，我们讲：currentChanged、tabBarClicked、tabBarDoubleClicked、tabCloseRequested。

3.1 信号一：currentChanged (int index)------ 标签页选中状态变更时触发

3.1.1 信号的核心定义

currentChanged 是 QTabWidget 最核心、最常用 的切换信号 ------ 它在选中的标签页发生变化时触发，参数为新选中标签页的索引 ；无选中标签页（如所有标签页被删除）时 index=-1。

触发场景包括：

用户点击不同标签页；
代码调用 setCurrentIndex()；
标签页关闭导致选中状态变更。

通俗理解：currentChanged 就像 "文件夹收纳册翻到另一页时通知你"------ 它会告诉你 "现在翻到的是第几页（索引）"；你可以在这个时候加载这一页的数据，或者更新界面状态。

这里有几个超级重要的规则，必须牢记，刻在脑子里：

触发规则（超级重要！） ：
- 仅选中状态变更时触发！
- 点击已选中的标签页不会触发此信号！
代码触发（超级重要！） ：
- 调用 setCurrentIndex() 也会触发此信号！
- 这点和 tabBarClicked 不一样！
索引有效性（超级重要！） ：
- 需先校验 index ≥ 0，再调用 tabText()/widget() 等方法！
- 避免越界！

3.1.2 信号参数详解

信号原型：

复制代码

void QTabWidget::currentChanged(int index);

参数说明：

index：int 类型，新选中标签页的索引；
- 从 0 开始；
- 无选中标签页时为 -1。

3.1.3 使用示例

复制代码

#include <QTabWidget>
#include <QWidget>
#include <QDebug>
#include <QObject> // connect

// 假设在 Widget 类的构造函数中，this 是父窗口，ui->tabWidget 已存在
// 示例：监听标签页切换信号，打印新选中标签页的文本
connect(ui->tabWidget, &QTabWidget::currentChanged,
        this, [=](int index){
    if (index >= 0) { // 【必须！】先校验索引有效！
        QString tabText = ui->tabWidget->tabText(index);
        qDebug() << "切换到标签页：" << tabText << "（索引：" << index << "）";
        // 【典型用法】业务逻辑：如切换标签页时加载对应模块数据
        // loadTabData(index);
    } else {
        qDebug() << "无选中的标签页";
        // 【典型用法】禁用依赖当前标签的工具栏按钮或清空状态栏
    }
});

3.1.4 关键注意事项（必知！）

仅选中状态变更时触发！（超级重要！说三遍！） ：
- 只有当选中的标签页从 A 变成 B 时，才会触发！
- 如果你点击的是已经选中的标签页；
- currentChanged 不会触发！
- 如果你想响应 "点击已选中标签页" 的操作，应该用 tabBarClicked 信号（后面会讲）！
代码调用 setCurrentIndex () 也会触发！（超级重要！） ：
- 这点和 tabBarClicked 不一样！
- tabBarClicked 仅响应用户手动点击！
- currentChanged 既响应用户点击，也响应代码调用 setCurrentIndex()！
- 如果你想避免代码调用时触发业务逻辑；
- 可以先断开信号连接，设置完 currentIndex 再重新连接！
必须先校验 index ≥ 0！（超级重要！说三遍！） ：
- 当所有标签页都被关闭时；
- index 会是 -1！
- 如果你直接调用 tabText(index) 或 widget(index)；
- 会导致越界访问，甚至程序崩溃！
- 必须先判断 index >= 0，再执行后续操作！
典型用法！ ：
- 懒加载：只有当切换到该标签时，才初始化内部繁重的控件或加载数据；
- 刷新数据：如果标签显示的是实时数据（如日志、监控图），在这里启动定时器或刷新逻辑；
- 更新 UI 状态：根据当前标签的类型，显示 / 隐藏特定的菜单项或工具栏按钮。

3.2 信号二：tabBarClicked (int index)------ 单击标签条（标签页标题区域）时触发

3.2.1 信号的核心定义

tabBarClicked 是 QTabWidget 用于响应用户单击标签条 的信号 ------ 只要用户点击标签条上的任意标签页（无论是否为当前选中标签页），就会触发此信号，参数为被点击标签页的索引；点击标签条空白区域时 index=-1。

通俗理解：tabBarClicked 就像 "用户用鼠标点了一下文件夹收纳册的某个标签时通知你"------ 不管这个标签是不是当前翻开的，只要点了就通知你；你可以用它实现 "点击已选中标签刷新数据" 的功能。

这里有几个超级重要的规则，必须牢记：

触发场景（超级重要！） ：
- 仅用户手动点击标签条时触发！
- 代码切换标签页（setCurrentIndex）不会触发！
- 这点和 currentChanged 不一样！
空白点击（超级重要！） ：
- 点击标签条的空白区域（无标签页处）时，index=-1！
- 需校验有效性！
优先级（超级重要！） ：
- 点击标签条会先触发 tabBarClicked！
- 再触发 currentChanged（若选中状态变更）！

3.2.2 信号参数详解

信号原型：

复制代码

void QTabWidget::tabBarClicked(int index);

参数说明：

index：int 类型，被点击标签页的索引；
- 从 0 开始；
- 点击空白标签条时为 -1。

3.2.3 使用示例

复制代码

#include <QTabWidget>
#include <QDebug>
#include <QObject>

// 假设在 Widget 类的构造函数中，this 是父窗口，ui->tabWidget 已存在
// 示例：监听标签条单击信号，即使点击已选中标签页也会响应
connect(ui->tabWidget, &QTabWidget::tabBarClicked,
        this, [=](int index){
    if (index >= 0) { // 【必须！】校验索引有效！
        QString tabText = ui->tabWidget->tabText(index);
        qDebug() << "单击标签条：" << tabText << "（索引：" << index << "）";
        
        // 【典型用法】实现"点击当前标签刷新"功能
        if (index == ui->tabWidget->currentIndex()) {
            qDebug() << "用户重复点击当前标签，执行刷新操作...";
            // refreshCurrentPageData();
        }
    } else {
        qDebug() << "单击了标签条空白区域";
    }
});

3.2.4 关键注意事项（必知！）

仅用户手动点击触发！（超级重要！说三遍！） ：
- 这点和 currentChanged 不一样！
- tabBarClicked 只响应用户的鼠标点击操作！
- 你在代码里调用 setCurrentIndex() 切换标签页；
- tabBarClicked 不会触发！
- 这是区分 "用户操作" 和 "代码操作" 的关键！
点击已选中标签页也会触发！（超级重要！） ：
- 这点和 currentChanged 不一样！
- currentChanged 只有在选中状态变更时才触发！
- tabBarClicked 只要点击了标签页就触发，不管是不是已选中的！
- 这是实现 "点击已选中标签刷新数据" 的核心！
点击空白区域 index=-1！（超级重要！） ：
- 如果用户点击的是标签条上没有标签页的空白区域；
- index 会是 -1！
- 必须先判断 index >= 0，再执行后续操作！
触发优先级！（超级重要！） ：
- 如果用户点击了一个未选中的标签页；
- 会先触发 tabBarClicked！
- 然后触发 currentChanged！
- 注意信号的触发顺序，避免逻辑冲突！

3.3 信号三：tabBarDoubleClicked (int index)------ 双击标签条（标签页标题区域）时触发

3.3.1 信号的核心定义

tabBarDoubleClicked 是 QTabWidget 用于响应用户双击标签条 的信号 ------ 用户双击标签条上的任意标签页时触发，参数为被双击标签页的索引；双击空白区域时 index=-1；常用于实现 "双击标签页重命名""双击新建标签页" 等自定义交互逻辑。

通俗理解：tabBarDoubleClicked 就像 "用户用鼠标快速双击了文件夹收纳册的某个标签时通知你"------ 你可以用它实现 "双击重命名标签""双击在新窗口打开" 等功能。

这里有几个超级重要的规则，必须牢记：

触发规则（超级重要！） ：
- 仅用户手动双击标签条时触发！
- 代码操作不会触发！
双击判定（超级重要！） ：
- 系统默认的双击间隔（可通过系统设置调整）；
- 快速单击两次会触发此信号；
索引校验（超级重要！） ：
- 双击空白标签条时 index=-1！
- 需先校验再操作！

3.3.2 信号参数详解

信号原型：

复制代码

void QTabWidget::tabBarDoubleClicked(int index);

参数说明：

index：int 类型，被双击标签页的索引；
- 从 0 开始；
- 双击空白标签条时为 -1。

3.3.3 使用示例

复制代码

#include <QTabWidget>
#include <QInputDialog>
#include <QLineEdit>
#include <QDebug>
#include <QObject>

// 假设在 Widget 类的构造函数中，this 是父窗口，ui->tabWidget 已存在
// 示例：监听标签条双击信号，实现双击重命名标签页
connect(ui->tabWidget, &QTabWidget::tabBarDoubleClicked,
        this, [=](int index){
    if (index >= 0) { // 【必须！】校验索引有效！
        qDebug() << "双击了标签页（索引：" << index << "）";
        
        // 【典型用法】弹出输入框，修改标签页文本
        QString oldText = ui->tabWidget->tabText(index);
        bool ok;
        QString newText = QInputDialog::getText(this, "重命名标签",
                                                "请输入新标签名：",
                                                QLineEdit::Normal,
                                                oldText, &ok);
        if (ok && !newText.isEmpty()) {
            ui->tabWidget->setTabText(index, newText);
            qDebug() << "标签页已重命名为：" << newText;
        }
    } else {
        qDebug() << "双击了标签条空白区域";
        // 【典型用法】双击空白区域新建标签页
        // addNewTab();
    }
});

3.3.4 关键注意事项（必知！）

仅用户手动双击触发！（超级重要！）；
双击判定！（超级重要！） ：
- 双击的判定是基于系统的双击间隔时间的；
- 不同用户的系统设置可能不一样；
- 快速单击两次就会触发；
- 第一次单击会触发 tabBarClicked，第二次双击会触发 tabBarDoubleClicked；
- 注意信号的触发顺序！
双击空白区域 index=-1！（超级重要！） ：
- 和 tabBarClicked 一样；
- 双击空白区域 index=-1；
- 你可以利用这个特性实现 "双击空白区域新建标签页" 的功能；
- 非常实用！
典型用法！ ：
- 最大化 / 还原当前标签页内容；
- 在新窗口中打开当前标签页的内容（类似浏览器的 "弹出窗口"）；
- 重命名标签：双击弹出对话框让用户修改 tabText；
- 双击空白区域新建标签页。

3.4 信号四：tabCloseRequested (int index)------ 点击标签页关闭按钮（×）时触发

3.4.1 信号的核心定义

tabCloseRequested 是 QTabWidget 用于响应用户关闭标签页请求 的信号 ------仅在 tabsCloseable=true（标签页显示关闭按钮）时生效 ；用户点击某标签页的关闭按钮后触发，参数为该标签页的索引；此信号仅表示 "用户请求关闭标签页"，不会自动删除标签页，需手动调用 removeTab(index) 实现关闭。

通俗理解：tabCloseRequested 就像 "用户点击了文件夹标签上的 × 按钮时通知你"------ 它只是告诉你 "用户想关闭这个标签页"；你可以在这个时候询问用户是否保存数据，确认后再手动调用 removeTab(index) 把标签页拿掉。

这里有几个超级重要的规则，必须牢记，刻在脑子里：

生效前提！（超级重要！说三遍！） ：
- 必须先设置 tabsCloseable=true！
- 否则标签页无关闭按钮，此信号不会触发！
手动关闭！（超级重要！说三遍！） ：
- 信号仅为 "请求"！
- 需调用 removeTab(index) 才会删除标签页！
- 可在删除前添加业务校验（如数据保存确认）！
内存释放！（超级重要！说三遍！） ：
- removeTab(index) 会移除标签页对应的 Widget，但不会自动释放其内存！
- 需手动 delete 或调用 deleteLater()（如需释放）！

3.4.2 信号参数详解

信号原型：

复制代码

void QTabWidget::tabCloseRequested(int index);

参数说明：

index：int 类型，用户请求关闭的标签页索引；
- 从 0 开始。

3.4.3 使用示例

复制代码

#include <QTabWidget>
#include <QMessageBox>
#include <QDebug>
#include <QObject>

// 假设在 Widget 类的构造函数中，this 是父窗口，ui->tabWidget 已存在
// 【必须！】第一步：先启用标签页关闭按钮
ui->tabWidget->setTabsCloseable(true);

// 第二步：监听标签页关闭请求，弹出确认框后再关闭
connect(ui->tabWidget, &QTabWidget::tabCloseRequested,
        this, [=](int index){
    // 1. 获取标签页信息
    QString tabTitle = ui->tabWidget->tabText(index);
    QWidget* widget = ui->tabWidget->widget(index);

    qDebug() << "[关闭请求] 请求关闭标签页：" << tabTitle << "（索引：" << index << "）";

    // 2. 【典型用法】弹出确认对话框，询问用户是否确认关闭
    QMessageBox::StandardButton res = QMessageBox::question(
        this,
        "确认关闭",
        QString("是否关闭标签页「%1」？\n未保存的数据将会丢失。").arg(tabTitle),
        QMessageBox::Yes | QMessageBox::No,
        QMessageBox::No // 默认按钮为 No
    );

    if (res == QMessageBox::Yes) {
        // 3. 【可选】清理工作：关闭文件句柄、停止线程、断开数据库连接等
        // cleanupWidget(widget);

        // 4. 【必须！】从 TabWidget 中移除标签页
        ui->tabWidget->removeTab(index);

        // 5. 【关键！】删除 Widget 本身（防止内存泄漏）
        // 注意：removeTab 只是把 widget 从布局中拿走，并没有 delete 它！
        if (widget != nullptr) {
            widget->deleteLater(); // 推荐使用 deleteLater 确保安全
            widget = nullptr;
        }

        qDebug() << "标签页「" << tabTitle << "」已关闭";

        // 6. 【可选】如果关闭后没有标签了，可能需要禁用某些功能或提示
        if (ui->tabWidget->count() == 0) {
            qDebug() << "所有标签页已关闭";
        }
    } else {
        qDebug() << "用户取消关闭标签页";
    }
});

3.4.4 关键注意事项（必知！）

生效前提：必须先 setTabsCloseable (true)！（超级重要！说三遍！） ：
- 这是最最最容易踩的坑！
- 如果你只监听了 tabCloseRequested 信号；
- 但没有调用 setTabsCloseable(true)；
- 标签页上根本不会显示关闭按钮！
- 用户根本无法点击关闭！
- 信号永远不会触发！
- 顺序不能反！必须先 setTabsCloseable(true)，再监听信号！
必须手动调用 removeTab (index)！（超级重要！说三遍！） ：
- 这是第二容易踩的坑！
- tabCloseRequested 信号只是 "通知你用户想关闭"！
- 它不会自动帮你关闭标签页！
- 你必须手动调用 ui->tabWidget->removeTab(index)！
- 标签页才会真正被移除！
- 这给了你一个机会：在关闭前询问用户是否保存数据，或者做一些清理工作！
必须手动释放 Widget 内存！（超级重要！说三遍！） ：
- 这是第三容易踩的坑！
- removeTab(index) 只是把标签页对应的 QWidget 从 QTabWidget 的布局中移除！
- 它不会自动 delete 这个 QWidget！
- 如果你不手动 delete，会导致内存泄漏！
- 推荐使用 widget->deleteLater() 来释放内存！
- deleteLater() 比直接 delete 更安全，因为它会在事件循环空闲时才删除对象，避免在信号槽中直接 delete 导致的崩溃！
典型用法！ ：
- 询问用户是否保存未提交的数据；
- 清理资源：关闭文件句柄、停止线程、断开数据库连接等；
- 确认删除；
- 释放 Widget 内存。

示例代码：

cpp 复制代码

#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QMessageBox>

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

    //OK，本文件我们就来学习QTabWidget的信号~~~
    //依旧是使用ui界面
    /**
     * @class QTabWidget
     * @brief Qt中QTabWidget的核心交互信号，覆盖标签页切换、点击、双击、关闭请求等核心操作场景
     * @details 这些信号是QTabWidget与业务逻辑联动的核心接口，所有信号均返回触发操作的标签页索引（从0开始）；
     *          不同信号对应不同的用户交互行为，可根据业务需求监听特定信号实现自定义逻辑（如标签页切换时加载数据、关闭时确认提示等）。
     *
     * 【核心特征】
     * 1. 切换信号：标签页选中状态变更时触发，区分"用户操作"和"代码设置"两种触发场景；
     * 2. 点击/双击信号：针对标签条的点击/双击操作触发，即使点击已选中的标签页也会生效；
     * 3. 关闭请求信号：仅在标签页显示关闭按钮（tabsCloseable=true）时触发，需手动实现关闭逻辑。
     */

    // ============================== 核心信号详解 ==============================

    /**
     * @signal void QTabWidget::currentChanged(int index)
     * @brief 标签页**选中状态变更**时触发的信号（切换标签页）
     * @details 当选中的标签页发生变化时触发，参数为**新选中标签页的索引**；无选中标签页（如所有标签页被删除）时index=-1；
     *          触发场景包括：用户点击不同标签页、代码调用setCurrentIndex()、标签页关闭导致选中状态变更。
     *
     * @参数说明：
     * @param index - int类型，新选中标签页的索引（0开始，无选中时为-1）。
     *
     * @使用示例：
     * // 监听标签页切换信号，打印新选中标签页的文本
     * connect(ui->tabWidget, &QTabWidget::currentChanged, this, [=](int index){
     *     if (index >= 0) {
     *         QString tabText = ui->tabWidget->tabText(index);
     *         qDebug() << "切换到标签页：" << tabText << "（索引：" << index << "）";
     *         // 业务逻辑：如切换标签页时加载对应模块数据
     *     } else {
     *         qDebug() << "无选中的标签页";
     *     }
     * });
     *
     * 【关键注意事项】
     * 1. 触发规则：仅选中状态**变更**时触发，点击已选中的标签页不会触发此信号；
     * 2. 代码触发：调用setCurrentIndex()会触发此信号，如需避免可先断开连接再操作；
     * 3. 索引有效性：需先校验index ≥ 0，再调用tabText()/widget()等方法，避免越界。
     */

    /**
     * @signal void QTabWidget::tabBarClicked(int index)
     * @brief **单击标签条**（标签页标题区域）时触发的信号
     * @details 只要用户点击标签条上的任意标签页（无论是否为当前选中标签页），就会触发此信号，参数为被点击标签页的索引；
     *          与currentChanged的核心区别：点击已选中的标签页时，tabBarClicked触发，currentChanged不触发。
     *
     * @参数说明：
     * @param index - int类型，被点击标签页的索引（0开始，点击空白标签条时为-1）。
     *
     * @使用示例：
     * // 监听标签条单击信号，即使点击已选中标签页也会响应
     * connect(ui->tabWidget, &QTabWidget::tabBarClicked, this, [=](int index){
     *     if (index >= 0) {
     *         qDebug() << "单击标签条：" << ui->tabWidget->tabText(index) << "（索引：" << index << "）";
     *         // 业务逻辑：如点击已选中标签页时刷新该页数据
     *     }
     * });
     *
     * 【关键注意事项】
     * 1. 触发场景：仅用户手动点击标签条时触发，代码切换标签页（setCurrentIndex）不会触发；
     * 2. 空白点击：点击标签条的空白区域（无标签页处）时，index=-1，需校验有效性；
     * 3. 优先级：点击标签条会先触发tabBarClicked，再触发currentChanged（若选中状态变更）。
     */

    /**
     * @signal void QTabWidget::tabBarDoubleClicked(int index)
     * @brief **双击标签条**（标签页标题区域）时触发的信号
     * @details 用户双击标签条上的任意标签页时触发，参数为被双击标签页的索引；
     *          常用于实现"双击标签页重命名""双击新建标签页"等自定义交互逻辑。
     *
     * @参数说明：
     * @param index - int类型，被双击标签页的索引（0开始，双击空白标签条时为-1）。
     *
     * @使用示例：
     * // 监听标签条双击信号，实现双击重命名标签页
     * connect(ui->tabWidget, &QTabWidget::tabBarDoubleClicked, this, [=](int index){
     *     if (index >= 0) {
     *         // 弹出输入框，修改标签页文本
     *         QString newText = QInputDialog::getText(this, "重命名", "请输入新标签名：",
     *                                                QLineEdit::Normal, ui->tabWidget->tabText(index));
     *         if (!newText.isEmpty()) {
     *             ui->tabWidget->setTabText(index, newText);
     *         }
     *     }
     * });
     *
     * 【关键注意事项】
     * 1. 触发规则：仅用户手动双击标签条时触发，代码操作不会触发；
     * 2. 双击判定：系统默认的双击间隔（可通过系统设置调整），快速单击两次会触发此信号；
     * 3. 索引校验：双击空白标签条时index=-1，需先校验再操作。
     */

    /**
     * @signal void QTabWidget::tabCloseRequest(int index)
     * @brief 点击标签页**关闭按钮（×）** 时触发的"关闭请求"信号
     * @details 仅在tabsCloseable=true（标签页显示关闭按钮）时生效，用户点击某标签页的关闭按钮后触发，参数为该标签页的索引；
     *          此信号仅表示"用户请求关闭标签页"，不会自动删除标签页，需手动调用removeTab(index)实现关闭。
     *
     * @参数说明：
     * @param index - int类型，用户请求关闭的标签页索引（0开始）。
     *
     * @使用示例：
     * // 监听标签页关闭请求，弹出确认框后再关闭
     * connect(ui->tabWidget, &QTabWidget::tabCloseRequest, this, [=](int index){
     *     // 弹出确认对话框
     *     QMessageBox::StandardButton res = QMessageBox::question(this, "确认关闭",
     *                                                             QString("是否关闭标签页「%1」？").arg(ui->tabWidget->tabText(index)),
     *                                                             QMessageBox::Yes | QMessageBox::No);
     *     if (res == QMessageBox::Yes) {
     *         // 手动删除标签页（核心：必须调用removeTab才会真正关闭）
     *         ui->tabWidget->removeTab(index);
     *         qDebug() << "关闭标签页：" << ui->tabWidget->tabText(index) << "（索引：" << index << "）";
     *     }
     * });
     *
     * 【关键注意事项】
     * 1. 生效前提：必须先设置tabsCloseable=true，否则标签页无关闭按钮，此信号不会触发；
     * 2. 手动关闭：信号仅为"请求"，需调用removeTab(index)才会删除标签页，可在删除前添加业务校验（如数据保存确认）；
     * 3. 内存释放：removeTab(index)会移除标签页对应的Widget，但不会自动释放其内存，需手动delete（如需释放）。
     */

    ui->tabWidget->setTabsClosable(true);
}

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


// 1. 当前标签页改变
void Widget::on_tabWidget_currentChanged(int index)
{
    // 触发时机：当用户点击另一个标签，或者通过代码 setCurrentIndex() 切换标签时触发。
    // 参数 index: 新选中的标签页索引 (从0开始)。如果所有标签都被关闭，index 为 -1。

    if (index == -1) {
        qDebug() << "[Tab Changed] 所有标签页已关闭，当前无选中项";
        // 典型用法：禁用依赖当前标签的工具栏按钮或清空状态栏
        return;
    }

    QString tabTitle = ui->tabWidget->tabText(index);
    QWidget *currentWidget = ui->tabWidget->widget(index);

    qDebug() << "[Tab Changed] 切换到索引:" << index << ", 标题:" << tabTitle;

    // 典型用法：
    // 1. 懒加载：只有当切换到该标签时，才初始化内部繁重的控件或加载数据。
    // 2. 刷新数据：如果标签显示的是实时数据（如日志、监控图），在这里启动定时器或刷新逻辑。
    // 3. 更新UI状态：根据当前标签的类型，显示/隐藏特定的菜单项或工具栏按钮。

    // 示例：如果是第2个标签，启动某个定时器
    /*
    if (index == 1) {
        m_timer->start();
    } else {
        m_timer->stop();
    }
    */
}

// 2. 标签栏被单击
void Widget::on_tabWidget_tabBarClicked(int index)
{
    // 触发时机：鼠标左键单击标签栏上的某个标签时触发。
    // 注意：即使点击的是"当前已经选中"的标签，这个信号也会触发！
    // 而 currentChanged 只有在索引真正变化时才会触发。

    QString title = ui->tabWidget->tabText(index);
    qDebug() << "[Tab Bar Clicked] 单击了标签 -> 索引:" << index << ", 标题:" << title;

    // 典型用法：
    // 1. 实现"点击当前标签刷新"功能：
    //    如果用户点击了当前正在看的标签，可以触发一次数据刷新。
    if (index == ui->tabWidget->currentIndex()) {
        qDebug() << "用户重复点击当前标签，执行刷新操作...";
        // refreshCurrentPageData();
    }

    // 2. 自定义右键菜单的辅助逻辑（虽然通常用 contextMenuEvent，但这里可以做点击计数等）。
}

// 3. 标签栏被双击
void Widget::on_tabWidget_tabBarDoubleClicked(int index)
{
    // 触发时机：快速双击标签栏上的某个标签。
    // 注意：Qt 默认版本中，双击标签通常没有内置行为，需要你自己定义。

    QString title = ui->tabWidget->tabText(index);
    qDebug() << "[Tab Bar Double Clicked] 双击了标签 -> 索引:" << index;

    // 典型用法：
    // 1. 最大化/还原当前标签页内容。
    // 2. 在新窗口中打开当前标签页的内容（类似浏览器的"弹出窗口"）。
    // 3. 重命名标签：双击弹出对话框让用户修改 tabText。

    // 示例：双击重命名
    /*
    bool ok;
    QString newText = QInputDialog::getText(this, "重命名标签", "请输入新标题:",
                                            QLineEdit::Normal, title, &ok);
    if (ok && !newText.isEmpty()) {
        ui->tabWidget->setTabText(index, newText);
    }
    */
}

// 4. 请求关闭标签页
void Widget::on_tabWidget_tabCloseRequested(int index)
{
    // 触发时机：用户点击标签页上的"x"关闭按钮时触发。
    // 前提：必须调用了 ui->tabWidget->setTabsClosable(true); 否则不会显示关闭按钮，也不会触发此信号。

    QWidget *widget = ui->tabWidget->widget(index);
    QString title = ui->tabWidget->tabText(index);

    qDebug() << "[Tab Close Requested] 请求关闭 -> 索引:" << index << ", 标题:" << title;

    // 典型用法：
    // 1. 询问用户是否保存未提交的数据。
    // 2. 清理资源：关闭文件句柄、停止线程、断开数据库连接等。
    // 3. 确认删除。

    // 示例：带确认框的关闭逻辑
    int ret = QMessageBox::question(this, "确认关闭",
                                    QString("确定要关闭 \"%1\" 吗？\n未保存的数据将会丢失。").arg(title),
                                    QMessageBox::Yes | QMessageBox::No, QMessageBox::No);

    if (ret == QMessageBox::Yes) {
        // 1. 清理工作 (如果有)
        // cleanupWidget(widget);

        // 2. 从 TabWidget 中移除
        ui->tabWidget->removeTab(index);

        // 3. 删除控件本身 (防止内存泄漏)
        // 注意：removeTab 只是把 widget 从布局中拿走，并没有 delete 它。
        if (widget) {
            widget->deleteLater(); // 推荐使用 deleteLater 确保安全
        }

        // 4. 如果关闭后没有标签了，可能需要禁用某些功能或提示
        if (ui->tabWidget->count() == 0) {
            qDebug() << "所有标签已关闭";
        }
    }
}

第四章综合示例：简易多标签页浏览器界面

讲完了所有核心属性和信号，我们最后来做一个综合示例，把所有内容都用到，展示 QTabWidget 的实际用法。

4.1 场景描述

我们要做一个 "简易多标签页浏览器" 界面，包含：

QTabWidget 主控件 ：
- 标签页在上方（North）；
- 标签页可关闭（显示 × 按钮）；
- 标签页可拖动调整顺序；
- 图标显示尺寸为 20x20 像素；
默认标签页 ：
- 两个默认标签页："首页" 和 "设置"；
- "首页" 标签页的 Widget 对象名为 "homeTab"；
- "设置" 标签页的 Widget 对象名为 "settingTab"；
功能：
- 切换标签时打印日志；
- 单击已选中标签时提示 "刷新数据"；
- 双击标签时可重命名；
- 关闭标签前弹出确认框，确认后关闭并释放内存。

4.2 代码实现

cpp 复制代码

#include "widget.h"
#include "ui_widget.h"
#include <QTabWidget>
#include <QWidget>
#include <QVBoxLayout>
#include <QLabel>
#include <QMessageBox>
#include <QInputDialog>
#include <QLineEdit>
#include <QIcon>
#include <QSize>
#include <QApplication>
#include <QStyle>
#include <QDebug>
#include <QObject>

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

    // 设置主窗口大小
    this->resize(600, 450);

    // ================= 1. 创建并配置 QTabWidget =================
    QTabWidget* tabWidget = new QTabWidget(this);
    // 设置 TabWidget 为主窗口的主布局（这里用简单的方式，直接 resize）
    tabWidget->setGeometry(20, 20, 560, 410);

    // 配置属性
    tabWidget->setTabPosition(QTabWidget::North);    // 标签页在上方（默认，可省略）
    tabWidget->setTabsCloseable(true);                // 显示关闭按钮
    tabWidget->setMovable(true);                       // 可拖动调整顺序
    tabWidget->setIconSize(QSize(20, 20));            // 图标尺寸 20x20

    // ================= 2. 创建默认标签页 1：首页 =================
    QWidget* homeTab = new QWidget();
    homeTab->setObjectName("homeTab"); // 设置 Widget 对象名（给程序看的）
    // 给首页标签页加个简单的布局和标签（演示用）
    QVBoxLayout* homeLayout = new QVBoxLayout(homeTab);
    QLabel* homeLabel = new QLabel("欢迎来到首页！", homeTab);
    homeLabel->setAlignment(Qt::AlignCenter);
    homeLayout->addWidget(homeLabel);
    // 添加到 TabWidget
    QIcon homeIcon = QApplication::style()->standardIcon(QStyle::SP_ComputerIcon);
    tabWidget->addTab(homeTab, homeIcon, "首页");
    // 设置悬浮提示
    tabWidget->setTabToolTip(0, "浏览器首页，展示常用网站");

    // ================= 3. 创建默认标签页 2：设置 =================
    QWidget* settingTab = new QWidget();
    settingTab->setObjectName("settingTab"); // 设置 Widget 对象名
    // 给设置标签页加个简单的布局和标签
    QVBoxLayout* settingLayout = new QVBoxLayout(settingTab);
    QLabel* settingLabel = new QLabel("这里是设置页面！", settingTab);
    settingLabel->setAlignment(Qt::AlignCenter);
    settingLayout->addWidget(settingLabel);
    // 添加到 TabWidget
    QIcon settingIcon = QApplication::style()->standardIcon(QStyle::SP_DirIcon);
    tabWidget->addTab(settingTab, settingIcon, "设置");
    // 设置悬浮提示
    tabWidget->setTabToolTip(1, "浏览器设置，包括外观、隐私等");

    // 默认选中首页（索引 0，默认，可省略）
    tabWidget->setCurrentIndex(0);

    // ================= 4. 绑定信号 =================
    // 信号 1：currentChanged ------ 标签页切换
    connect(tabWidget, &QTabWidget::currentChanged,
            this, [=](int index){
        if (index >= 0) {
            QString tabText = tabWidget->tabText(index);
            QWidget* widget = tabWidget->widget(index);
            QString tabName = widget ? widget->objectName() : "未知";
            qDebug() << "[切换] 到标签页：" << tabText
                     << "（索引：" << index << "，Name：" << tabName << "）";
            
            // 根据 tabName 执行不同逻辑
            if (tabName == "homeTab") {
                qDebug() << "  → 执行首页初始化逻辑...";
            } else if (tabName == "settingTab") {
                qDebug() << "  → 执行设置页初始化逻辑...";
            }
        } else {
            qDebug() << "[切换] 无选中标签页";
        }
    });

    // 信号 2：tabBarClicked ------ 单击标签条
    connect(tabWidget, &QTabWidget::tabBarClicked,
            this, [=](int index){
        if (index >= 0) {
            QString tabText = tabWidget->tabText(index);
            qDebug() << "[单击] 标签页：" << tabText << "（索引：" << index << "）";
            
            // 如果单击的是当前选中标签，提示刷新
            if (index == tabWidget->currentIndex()) {
                qDebug() << "  → 重复点击当前标签，模拟刷新数据...";
                // 这里可以弹出一个提示框（仅作演示）
                // QMessageBox::information(this, "刷新", "已刷新「" + tabText + "」的数据");
            }
        } else {
            qDebug() << "[单击] 标签条空白区域";
        }
    });

    // 信号 3：tabBarDoubleClicked ------ 双击标签条
    connect(tabWidget, &QTabWidget::tabBarDoubleClicked,
            this, [=](int index){
        if (index >= 0) {
            qDebug() << "[双击] 标签页（索引：" << index << "），准备重命名...";
            QString oldText = tabWidget->tabText(index);
            bool ok;
            QString newText = QInputDialog::getText(this, "重命名标签",
                                                    "请输入新标签名：",
                                                    QLineEdit::Normal,
                                                    oldText, &ok);
            if (ok && !newText.isEmpty()) {
                tabWidget->setTabText(index, newText);
                qDebug() << "  → 标签页已重命名为：" << newText;
            } else {
                qDebug() << "  → 取消重命名";
            }
        } else {
            qDebug() << "[双击] 标签条空白区域（可在此实现新建标签页）";
        }
    });

    // 信号 4：tabCloseRequested ------ 关闭请求
    connect(tabWidget, &QTabWidget::tabCloseRequested,
            this, [=](int index){
        QString tabTitle = tabWidget->tabText(index);
        QWidget* widget = tabWidget->widget(index);
        qDebug() << "[关闭请求] 标签页：" << tabTitle << "（索引：" << index << "）";

        // 弹出确认框
        QMessageBox::StandardButton res = QMessageBox::question(
            this,
            "确认关闭",
            QString("是否关闭标签页「%1」？").arg(tabTitle),
            QMessageBox::Yes | QMessageBox::No,
            QMessageBox::No
        );

        if (res == QMessageBox::Yes) {
            // 移除标签页
            tabWidget->removeTab(index);
            // 释放 Widget 内存
            if (widget != nullptr) {
                widget->deleteLater();
                qDebug() << "  → 标签页「" << tabTitle << "」已关闭，内存已释放";
            }
        } else {
            qDebug() << "  → 用户取消关闭";
        }
    });
}

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

第五章全文总结与学习建议

恭喜你！终于看完了这篇 QTabWidget 详细解析！

如果你跟着文章一步步敲了代码，做了练习，那么现在你已经完全掌握了 QTabWidget 的核心内容：

你知道了 QTabWidget 是带标签页的多页面容器，用来在有限空间内展示多个功能模块；
你知道了 QTabWidget 和 QGroupBox 的核心区别；
你知道了往 QTabWidget 里添加标签页的核心原则 ------ 先创建 QWidget，再布局，再 addTab；
你会用 QTabWidget 的 tabPosition、currentIndex、currentTabText、currentTabName、currentTabIcon、currentTabToolTip、tabsCloseable、movable 这些属性定制标签页；
你会绑定 QTabWidget 的 currentChanged、tabBarClicked、tabBarDoubleClicked、tabCloseRequested 这些信号实现交互；
你知道了必须先 setTabsCloseable (true) 才能有关闭按钮 、点击关闭按钮必须手动 removeTab 和 deleteLater 、索引从 0 开始这些超级重要的注意事项。

毫不夸张地说，掌握了这些内容，你就掌握了 QTabWidget 开发的 95% 以上的需求！

5.1 核心要点回顾

在结束之前，我们最后再回顾一下这篇文章的核心要点，特别是那些最容易踩坑的地方：

添加标签页的核心原则！（超级重要！开篇就讲！） ：
- 先创建 QWidget 对象；
- 给 QWidget 设置布局并添加子控件；
- 最后调用 addTab() 将 QWidget 添加为标签页；
- QTabWidget 不能直接 addWidget()！
索引从 0 开始！（超级重要！说三遍！） ：
- 所有标签页的索引都从 0 开始！
- 第一个标签页永远是 0！
tabsCloseable 的三个超级重要！（超级重要！说三遍！） ：
- 必须先 setTabsCloseable(true) 才能显示关闭按钮！
- 点击关闭按钮只会触发 tabCloseRequested 信号，不会自动关闭！
- 必须手动调用 removeTab(index) 才能关闭标签页！
- 必须手动调用 deleteLater() 释放 Widget 内存！
信号触发区别！（超级重要！） ：
- currentChanged：选中状态变更时触发，代码调用 setCurrentIndex() 也触发，点击已选中标签不触发；
- tabBarClicked：用户点击标签条时触发，代码操作不触发，点击已选中标签也触发；
- tabBarDoubleClicked：用户双击标签条时触发；
- tabCloseRequested：用户点击关闭按钮时触发，需先 setTabsCloseable(true)；
currentTabText/Name/Icon/ToolTip 是组合操作！（超级重要！） ：
- 不是官方直接属性；
- 需通过 currentIndex() + 对应的 API 组合使用；
- 必须先判断 currentIndex() ≥ 0！
默认值总结 ：
- tabPosition：QTabWidget::North（上方）；
- tabsCloseable：false（不显示关闭按钮）；
- movable：false（不可拖动）；
- currentIndex：无标签页时 -1，有标签页时默认 0。

5.2 最后的话

编程学习没有捷径，唯手熟尔。QTabWidget 的内容虽然不少，但细节很多，只要你多敲代码、多做练习、多踩坑、多排查，很快就能熟练掌握。

这篇文章虽然很长，但我相信，如果你认真看完了，跟着敲了代码，你一定会对 QTabWidget 有一个极其深刻的理解，再也不会为多标签页界面开发发愁。

感谢你阅读这篇文章，希望它能帮到你。我们下一篇 Qt 教程再见！

对于Qt：QTabWidget常见属性的解析

开篇介绍：

第一章 先搞懂基础：QTabWidget 是什么？为什么要用它？

1.1 QTabWidget 的核心定位

1.2 QTabWidget 和 QGroupBox 的核心区别（必知！）

1.3 往 QTabWidget 中添加标签页的核心原则（开篇就讲，刻在脑子里！）

第二章 QTabWidget 核心属性详解

2.1 属性一：tabPosition------ 标签页在控件中的显示位置

2.1.1 属性的核心定义

2.1.2 核心枚举值（QTabWidget::TabPosition）

2.1.3 关联 API 详解（逐词逐句，零模糊）

1. 获取当前标签页位置：QTabWidget::TabPosition tabPosition () const

2. 设置标签页位置：void setTabPosition (QTabWidget::TabPosition position)

2.1.4 使用示例

2.1.5 关键注意事项（必知！）

2.2 属性二：currentIndex------ 当前选中标签页的索引（从 0 开始计算）

2.2.1 属性的核心定义

2.2.2 关联 API 详解（逐词逐句，零模糊）

1. 获取当前选中标签页的索引：int currentIndex () const

2. 设置选中指定索引的标签页：void setCurrentIndex (int index)

2.2.3 使用示例

2.2.4 关键注意事项（必知！）

2.3 属性三：currentTabText------ 当前选中标签页的显示文本

2.3.1 属性的核心定义

2.3.2 关联 API 详解（逐词逐句，零模糊）

1. 获取指定索引标签页的文本：QString tabText (int index) const

2. 设置指定索引标签页的文本：void setTabText (int index, const QString& text)

3. 组合操作：获取 / 设置当前标签页的文本

2.3.3 使用示例

2.3.4 关键注意事项（必知！）

2.4 属性四：currentTabName------ 当前选中标签页对应的 Widget 对象名

2.4.1 属性的核心定义

2.4.2 关联 API 详解（逐词逐句，零模糊）

1. 获取指定索引标签页对应的 Widget：QWidget* widget (int index) const

2. 组合操作：获取 / 设置当前标签页 Widget 的对象名

2.4.3 使用示例

2.4.4 关键注意事项（必知！）

2.5 属性五：currentTabIcon------ 当前选中标签页的显示图标

2.5.1 属性的核心定义

2.5.2 关联 API 详解（逐词逐句，零模糊）

1. 获取指定索引标签页的图标：QIcon tabIcon (int index) const

2. 设置指定索引标签页的图标：void setTabIcon (int index, const QIcon& icon)

3. 设置图标显示尺寸：void setIconSize (const QSize& size)

4. 组合操作：获取 / 设置当前标签页的图标

2.5.3 使用示例

2.5.4 关键注意事项（必知！）

2.6 属性六：currentTabToolTip------ 当前选中标签页的鼠标悬浮提示信息

2.6.1 属性的核心定义

2.6.2 关联 API 详解（逐词逐句，零模糊）

1. 获取指定索引标签页的提示信息：QString tabToolTip (int index) const

2. 设置指定索引标签页的提示信息：void setTabToolTip (int index, const QString& tip)

3. 组合操作：获取 / 设置当前标签页的提示信息

2.6.3 使用示例

2.6.4 关键注意事项（必知！）

2.7 属性七：tabsCloseable------ 所有标签页是否显示关闭按钮（×）

2.7.1 属性的核心定义

2.7.2 关联 API 详解（逐词逐句，零模糊）

1. 判断是否显示关闭按钮：bool tabsCloseable () const

2. 设置是否显示关闭按钮：void setTabsCloseable (bool closeable)

2.7.3 使用示例

2.7.4 关键注意事项（必知！）

2.8 属性八：movable------ 标签页是否可通过鼠标拖动调整顺序

2.8.1 属性的核心定义

2.8.2 关联 API 详解（逐词逐句，零模糊）

1. 判断标签页是否可移动：bool isMovable () const

2. 设置是否可移动：void setMovable (bool movable)

2.8.3 使用示例

2.8.4 关键注意事项（必知！）

示例代码：

第三章 QTabWidget 核心交互信号详解

3.1 信号一：currentChanged (int index)------ 标签页选中状态变更时触发

3.1.1 信号的核心定义

3.1.2 信号参数详解

3.1.3 使用示例

3.1.4 关键注意事项（必知！）

3.2 信号二：tabBarClicked (int index)------ 单击标签条（标签页标题区域）时触发

3.2.1 信号的核心定义

3.2.2 信号参数详解

3.2.3 使用示例

3.2.4 关键注意事项（必知！）

第一章先搞懂基础：QTabWidget 是什么？为什么要用它？

第四章综合示例：简易多标签页浏览器界面

第五章全文总结与学习建议