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

news2024/11/16 7:50:16

概述

QToolBox类提供了一个列式的带有选项卡的小部件条目。工具箱是一个小部件，以一个列式的选项卡显示在上方，并在当前选项卡下方显示当前的小部件条目。每个选项卡在选项卡列中有一个索引位置。选项卡的小部件条目是一个QWidget。

每个小部件条目都有一个itemText()方法获取文本，可选的itemIcon()方法获取图标，itemToolTip()方法获取工具提示，以及widget()方法获取小部件。可以使用setItemText()、setItemIcon()和setItemToolTip()方法更改小部件条目的属性。可以使用setItemEnabled()方法单独启用或禁用每个小部件条目。

使用addItem()方法添加小部件条目，或使用insertItem()方法在特定位置插入小部件条目。使用count()方法获取小部件条目的总数。可以使用delete关键字删除小部件条目，或使用removeItem()方法从工具箱中移除小部件条目。结合removeItem()和insertItem()方法，可以将小部件条目移动到不同的位置。

使用currentIndex()方法返回当前小部件条目的索引，使用setCurrentIndex()方法设置当前小部件条目的索引。可以使用indexOf()查找特定小部件条目的索引，使用item()方法返回给定索引的小部件条目。

当前小部件条目改变时，会触发currentChanged()信号。

常用函数

addItem(QWidget *widget, const QString &text): 将一个小部件(widget)添加到工具箱中，并指定显示的文本。
insertItem(int index, QWidget *widget, const QString &text): 在指定位置(index)插入一个小部件(widget)到工具箱中，并指定显示的文本。
removeItem(int index): 从工具箱中移除指定位置(index)的小部件。
count(): 返回工具箱中小部件条目的总数。
currentIndex(): 返回当前选中的小部件条目的索引。
setCurrentIndex(int index): 设置当前选中的小部件条目的索引。
indexOf(QWidget *widget): 返回指定小部件(widget)在工具箱中的索引。
item(int index): 返回指定索引位置(index)的小部件条目。
setItemText(int index, const QString &text): 设置指定索引位置(index)的小部件条目的文本。
setItemIcon(int index, const QIcon &icon): 设置指定索引位置(index)的小部件条目的图标。
setItemToolTip(int index, const QString &toolTip): 设置指定索引位置(index)的小部件条目的工具提示。
setItemEnabled(int index, bool enabled): 设置指定索引位置(index)的小部件条目是否启用。

信号：

currentChanged(int index): 当前选中的小部件条目改变时触发该信号，返回变化后的索引。

槽：

void setCurrentIndex(int index)：设置当前下标。
void setCurrentWidget(QWidget *widget)：设置当前控件。

除了上述介绍的常用函数、枚举、信号和槽之外，QToolBox还提供了其他函数和特性，用于进一步定制和管理工具箱中的小部件条目。可以参考官方文档进一步了解QToolBox的全部功能和使用方法。

示例

以下代码，实现了添加小部件、移除小部件、设置小部件是否启用以及使用信号和槽改变当前小部件。

#include <QApplication>
#include <QToolBox>
#include <QPushButton>
#include <QLabel>
#include <QDebug>

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

    // 添加小部件
    QPushButton *button1 = new QPushButton("Button 1");
    QLabel *label1 = new QLabel("Label 1");
    QPushButton *button2 = new QPushButton("Button 2");
    QLabel *label2 = new QLabel("Label 2");
    
    toolBox.addItem(button1, "Button 1");
    toolBox.addItem(label1, "Label 1");
    toolBox.addItem(button2, "Button 2");
    toolBox.addItem(label2, "Label 2");
    
    // 移除小部件
    // toolBox.removeItem(2); // 移除索引为2的小部件
    
    // 设置是否启用小部件
    // toolBox.setItemEnabled(1, false); // 禁用索引为1的小部件
    
    // 信号和槽
    QObject::connect(&toolBox, &QToolBox::currentChanged, [&](int index){
        qDebug() << "Current Index Changed: " << index;
    });
    
    QObject::connect(button1, &QPushButton::clicked, [&](){
        toolBox.setCurrentIndex(1); // 点击Button 1时，将当前小部件设置为索引为1的小部件
    });
    
    toolBox.show();

    return app.exec();
}

在这里插入图片描述
在示例中，创建了一个QToolBox，并添加了四个小部件：两个QPushButton和两个QLabel。可以通过调用addItem()函数将小部件添加到工具箱中，并使用设置的文本显示在选项卡中。如果要移除特定位置的小部件，可以使用removeItem()函数。要设置小部件是否启用，可以使用setItemEnabled()函数。