深入浅出之QTabBar

QTabBar类是Qt框架中用于创建选项卡栏的一个控件。以下是对QTabBar的详细介绍：

一、基本概念

QTabBar提供了一个选项卡栏，通常用于选项卡对话框。它使用预定义的形状绘制选项卡，并在选择选项卡时发出信号。QTabBar可以被子类化以调整其外观和感觉。

二、常用函数

2.1 选项卡管理

1. addTab(const QString &text)
   • 添加一个新的选项卡，并设置其文本。
2. insertTab(int index, const QString &text)
   • 在指定位置插入一个新的选项卡，并设置其文本。
3. removeTab(int index)
   • 移除指定索引位置的选项卡。
4. count()
   • 返回选项卡栏中选项卡的数量。

2.2 选项卡属性设置

1. setTabText(int index, const QString &text)
   • 设置指定索引位置的选项卡的文本。
2. setTabIcon(int index, const QIcon &icon)
   • 设置指定索引位置的选项卡的图标。
3. setTabToolTip(int index, const QString &tip)
   • 设置指定索引位置的选项卡的工具提示。
4. setTabWhatsThis(int index, const QString &text)
   • 设置指定索引位置的选项卡的 WhatsThis 帮助文本。
5. setTabEnabled(int index, bool enabled)
   • 启用或禁用指定索引位置的选项卡。
6. setTabTextColor(int index, const QColor &color)
   • 设置指定索引位置的选项卡的文本颜色。
7. setTabData(int index, const QVariant &data)
   • 为指定索引位置的选项卡设置附加数据。

2.3 选项卡属性获取

1. tabText(int index)
   • 返回指定索引位置的选项卡的文本。
2. tabIcon(int index)
   • 返回指定索引位置的选项卡的图标。
3. tabToolTip(int index)
   • 返回指定索引位置的选项卡的工具提示。
4. tabWhatsThis(int index)
   • 返回指定索引位置的选项卡的 WhatsThis 帮助文本。
5. tabData(int index)
   • 返回指定索引位置的选项卡的附加数据。
6. tabTextColor(int index)
   • 返回指定索引位置的选项卡的文本颜色。

2.4 外观和形状设置

1. setShape(Shape shape)
   • 设置选项卡的外观形状，如 RoundedNorth、RoundedSouth、TriangularNorth 和 TriangularSouth 等。
2. setIconSize(const QSize &size)
   • 设置选项卡栏中图标的大小。
3. setDrawBase(bool drawBase)
   • 设置是否绘制选项卡的基线。
4. setElideMode(Qt::TextElideMode mode)
   • 设置当选项卡标签文本过长时的省略模式。

2.5 信号（Signals）

1. currentChanged(int index)

   • 当当前选项卡发生变化时发出的信号。
   • index 参数表示新选项卡的索引。
   • 这是一个常用的信号，通常用于在选项卡切换时执行某些操作，如更新界面内容或显示不同的信息。

2. tabBarClicked(int index)（注意：这个信号可能不是 QTabBar 标准 API 的一部分，而是某些特定实现或版本中提供的，具体请参考 Qt 官方文档）

   • 当选项卡被单击时发出的信号。
   • index 参数表示被单击选项卡的索引。
   • 这个信号可以用于处理选项卡单击事件，如显示与该选项卡相关的内容或执行某些操作。

3. tabBarDoubleClicked(int index)（同样，这个信号可能不是标准 API 的一部分）

   • 当选项卡被双击时发出的信号。
   • index 参数表示被双击选项卡的索引。
   • 这个信号可以用于处理选项卡双击事件，如打开与该选项卡相关的对话框或执行其他特定操作。

4. tabCloseRequested(int index)

   • 当点击选项卡上的关闭按钮时发出的信号。
   • index 参数表示应删除的选项卡的索引。
   • 这个信号通常用于处理选项卡的关闭请求，如从选项卡栏中移除该选项卡或显示一个确认关闭的对话框。

5. tabMoved(int from, int to)

   • 当选项卡从索引 from 处移动到索引 to 处时发出的信号。
   • from 和 to 参数分别表示移动前后的索引。
   • 这个信号可以用于处理选项卡移动事件，如更新界面布局或重新排列选项卡顺序。

2.6 槽函数（Slots）

1. setCurrentIndex(int index)

   • 设置当前选中的选项卡的索引。
   • index 参数表示要设置为当前选项卡的索引。
   • 这是一个槽函数，可以通过编程方式调用它来更改当前选中的选项卡。

需要注意的是，QTabBar 本身可能并不直接提供所有的这些槽函数，特别是像 tabBarClicked 和 tabBarDoubleClicked 这样的信号可能需要在子类化 QTabBar 或使用其他方法时自定义实现。此外，Qt 的版本更新可能会引入新的信号和槽函数，因此建议查阅最新的 Qt 官方文档以获取最准确的信息。

在 Qt 中，信号和槽函数是通过 QObject 的 connect 函数来关联的。当信号被发出时，与之连接的槽函数会被自动调用。这使得对象之间的通信更加灵活和方便，同时也实现了很好的解耦。

2.7 其他函数

1. tabSizeHint(int index)
   • 计算并返回指定索引位置的选项卡的大小。这个函数通常用于子类化 QTabBar 时重写，以提供自定义的选项卡大小。
2. tabRect(int index)
   • 返回单个选项卡的可视几何形状（矩形区域）。这个函数对于绘制自定义选项卡或处理选项卡事件时可能很有用。

这些函数提供了对 QTabBar 的全面控制，允许开发者根据需要创建和管理选项卡栏。通过子类化 QTabBar 并重写相关函数，还可以进一步定制其外观和行为。

三、示例 

#include <QApplication>
#include <QTabBar>
#include <QMessageBox>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // 创建一个主窗口
    QWidget window;
    window.setWindowTitle("Tab Bar Example");

    // 创建一个选项卡栏
    QTabBar tabBar(&window);

    // 添加选项卡
    tabBar.addTab("Tab 1");
    tabBar.addTab("Tab 2");
    tabBar.addTab("Tab 3");

    // 设置当前选中的选项卡
    tabBar.setCurrentIndex(0);

    // 连接信号currentChanged()到槽函数，处理选项卡的切换
    QObject::connect(&tabBar, &QTabBar::currentChanged, [&](int index) {
        QMessageBox::information(&window, "Tab Changed", "Switched to Tab " + QString::number(index + 1));
    });

    // 设置选项卡栏的布局和大小
    tabBar.setGeometry(20, 20, 200, 30);

    // 显示窗口
    window.show();
    return app.exec();
}

四、注意事项

1. QTabBar仅提供了一个选项卡栏，并没有为每个选项卡提供相应的页面。要使选项卡栏实际可用，需要自行为每个选项卡设置需要显示的内容。这通常结合QStackedLayout或QStackedWidget来实现页面切换。
2. QTabBar的外观和感觉可以通过子类化并重新实现相关方法（如paintEvent()、tabSizeHint()等）来调整。

综上所述，QTabBar是Qt框架中用于创建选项卡栏的一个强大控件，它提供了丰富的功能和选项来满足不同的界面设计需求。

参考：

1. QTabBar Class | Qt Widgets 5.15.18