QT控件-QTabWidget

一、介绍

  QTabWidget是Qt中用于创建带有多个选项卡的界面控件，每个选项卡可以包含不同的内容。用户可以通过点击选项卡切换显示不同的页面或功能。

        在design拖控件效果如下图，选tab1可以看到

        或者选tab2：

        就像WPS中的这个效果：

二、实现

addTab函数

        下面是一个简单的示例代码，演示如何创建和使用QTabWidget控件：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 创建两个选项卡页面
QWidget* page1 = new QWidget();
QWidget* page2 = new QWidget();
// 将选项卡页面添加到QTabWidget中，并指定每个选项卡的标题
tabWidget->addTab(page1, "选项卡1");
tabWidget->addTab(page2, "选项卡2");
// 设置选项卡的样式
tabWidget->setTabPosition(QTabWidget::North); // 或者 QTabWidget::South, QTabWidget::West, QTabWidget::East
tabWidget->setTabShape(QTabWidget::Triangular); // 或者 QTabWidget::Rounded
// 将QTabWidget添加到布局中或设置为窗口的中心部件
layout->addWidget(tabWidget);
// 或者
setCentralWidget(tabWidget);

        在这个示例中，首先创建了一个QTabWidget对象tabWidget。然后，创建了两个选项卡页面page1和page2，可以根据需要进行自定义内容的添加和设置。接着，通过调用addTab()函数将选项卡页面添加到tabWidget中，并指定每个选项卡的标题。

        可以使用setTabPosition()函数设置选项卡的位置，可用的选项包括QTabWidget::North（上方）、QTabWidget::South（下方）、QTabWidget::West（左侧）和QTabWidget::East（右侧）。还可以使用setTabShape()函数设置选项卡的形状，可选值包括QTabWidget::Triangular（梯形）和QTabWidget::Rounded（圆角）。

        最后，将tabWidget添加到布局中或将其设置为窗口的中心部件。这样就可以在界面中显示一个带有选项卡的界面控件了。

insertTab函数

        也可以使用QTabWidget类中的insertTab()函数在指定位置插入一个新的选项卡，insertTab()函数有两个重载形式，具体如下：

int insertTab(int index, QWidget *widget, const QString &label);
这个重载函数用于在指定位置index插入一个没有图标的选项卡，并设置选项卡的标题为label。它返回插入选项卡的索引。
 
int insertTab(int index, QWidget *widget, const QIcon &icon, const QString &label);
这个重载函数用于在指定位置index插入一个带有图标的选项卡，并设置选项卡的标题为label。icon参数指定了选项卡的图标。它返回插入选项卡的索引。

        以下示例演示如何使用这两个函数插入选项卡：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 创建两个选项卡页面
QWidget* page1 = new QWidget();
QWidget* page2 = new QWidget();
// 在指定位置插入选项卡
tabWidget->insertTab(0, page1, "选项卡1");
tabWidget->insertTab(1, page2, QIcon(":/icons/tab_icon.png"), "选项卡2");

        在上述示例中，通过调用insertTab()函数在第一个位置插入了一个没有图标的选项卡，标题为"选项卡1"，在第二个位置插入了一个带有图标的选项卡，标题为"选项卡2"。

        需要注意的是，index参数表示插入选项卡的位置，其中0表示第一个位置。如果index超出了当前选项卡的范围，则该选项卡将被添加到最后。

QTabWidget类中定义的信号

  QTabWidget类中定义的一些信号，用于在选项卡状态发生变化时进行通知和处理。以下是每个信号的说明：

currentChanged(int index)：
当当前选中的选项卡发生变化时，会触发该信号。index参数表示当前选中的选项卡的索引。
 
tabCloseRequested(int index)：
当用户请求关闭某个选项卡时，会触发该信号。index参数表示要关闭的选项卡的索引。
 
tabBarClicked(int index)：
当用户单击选项卡标签时，会触发该信号。index参数表示被单击选项卡的索引。
 
tabBarDoubleClicked(int index)：
当用户双击选项卡标签时，会触发该信号。index参数表示被双击选项卡的索引。

        这些信号可以用于连接到相应的槽函数，以便在选项卡状态变化时执行特定的操作。例如，可以使用currentChanged()信号来检测用户切换选项卡，并根据需要更新界面内容。或者，可以使用tabCloseRequested()信号来实现自定义的选项卡关闭逻辑。

        以下是一个示例代码，演示如何连接这些信号：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
 
// ...
 
// 连接currentChanged信号
connect(tabWidget, &QTabWidget::currentChanged, [=](int index) {
    // 当前选项卡发生变化时的操作
    qDebug() << "当前选项卡索引：" << index;
});
 
// 连接tabCloseRequested信号
connect(tabWidget, &QTabWidget::tabCloseRequested, [=](int index) {
    // 关闭选项卡的操作
    qDebug() << "关闭选项卡索引：" << index;
});
 
// 连接tabBarClicked信号
connect(tabWidget, &QTabWidget::tabBarClicked, [=](int index) {
    // 单击选项卡标签的操作
    qDebug() << "单击选项卡索引：" << index;
});
 
// 连接tabBarDoubleClicked信号
connect(tabWidget, &QTabWidget::tabBarDoubleClicked, [=](int index) {
    // 双击选项卡标签的操作
    qDebug() << "双击选项卡索引：" << index;
});

setTabsClosable函数

  QTabWidget类的一个成员函数，用于设置选项卡是否可关闭。当调用setTabsClosable(true)时，选项卡就可以通过用户点击关闭按钮进行关闭。

        以下是一个示例代码，演示如何使用setTabsClosable()函数设置选项卡为可关闭：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 设置选项卡为可关闭
tabWidget->setTabsClosable(true);
 
// ...
 
// 连接tabCloseRequested信号
connect(tabWidget, &QTabWidget::tabCloseRequested, [=](int index) {
    // 关闭选项卡的操作
    qDebug() << "关闭选项卡索引：" << index;
    // 关闭选项卡
    tabWidget->removeTab(index);
});

        在上述示例中，通过调用setTabsClosable(true)将选项卡设置为可关闭。然后，使用connect()函数连接tabCloseRequested信号到一个槽函数。在该槽函数中，可以根据需要执行自定义的关闭选项卡的操作，例如打印调试信息、更新界面，并使用removeTab()函数从QTabWidget中移除选项卡。

setMovable函数

  QTabWidget类的一个成员函数，用于设置选项卡是否可移动。当调用setMovable(true)时，用户可以通过拖拽选项卡来进行重新排序。

        以下是一个示例代码，演示如何使用setMovable()函数设置选项卡为可移动：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 设置选项卡为可移动
tabWidget->setMovable(true);

setTabPosition函数

  QTabWidget类的一个成员函数，用于设置选项卡的位置。你可以使用这个函数来指定选项卡在QTabWidget中的位置，可以是上方、下方、左侧或右侧。

        以下是一个示例代码，演示如何使用setTabPosition()函数设置选项卡的位置：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 设置选项卡的位置为左侧
tabWidget->setTabPosition(QTabWidget::West);

        你可以根据需要选择QTabWidget::North（上方）、QTabWidget::South（下方）、QTabWidget::West（左侧）或QTabWidget::East（右侧）作为参数，以将选项卡放置在不同的位置。

setTabShape函数

        QTabWidget类的一个成员函数，用于设置选项卡的形状。你可以使用这个函数来指定选项卡的形状，可以是矩形、圆形或倒角矩形。

        以下是一个示例代码，演示如何使用setTabShape()函数设置选项卡的形状：

// 创建一个QTabWidget对象
QTabWidget* tabWidget = new QTabWidget(this);
// 设置选项卡的形状为圆形
tabWidget->setTabShape(QTabWidget::Rounded);
 
// ...
 
// 在QTabWidget中添加一个选项卡
tabWidget->addTab(new QWidget(), "选项卡标题");

        可以根据需要选择QTabWidget::Rounded（圆形）或 QTabWidget::Triangular（梯形）作为参数，以将选项卡的形状设置为不同的样式