Qt QComboBox详解

一、QComboBox概述

Qt QComboBox控件是一种常用的下拉框控件，它可以展示一个列表供用户选择，用户可以通过下拉列表选项来选择所需的选项。QComboBox不仅可以用于输入数据，也可以被用来跳转到其它页面或显示其它数据。

下面是一个QComboBox控件的基本代码实例：

    QComboBox *comboBox = new QComboBox;
    comboBox->addItem(tr("Item 1"));
    comboBox->addItem(tr("Item 2"));
    comboBox->addItem(tr("Item 3"));
    comboBox->addItems(QStringList() << tr("Item 4") << tr("Item 5") << tr("Item 6"));

以上代码的含义是创建一个QComboBox控件，同时在其下拉列表中添加了"Item 1"，"Item 2"，"Item 3"，"Item 4"，"Item 5"和"Item 6"六个选项。

二、QComboBox常用属性和方法

1. addItem

addItem方法用于在QComboBox下拉列表中添加一个选项，该方法有多个重载。

    void QComboBox::addItem(const QString &text, const QVariant &userData = QVariant());
    void QComboBox::insertItem(int index, const QString &text, const QVariant &userData = QVariant());
    void QComboBox::addItems(const QStringList &texts);

其中，第一个重载方法添加一个选项，可以设置选项的文字和用户数据；第二个重载方法在指定位置插入一个选项；第三个重载方法在末尾插入多个选项。

2. setCurrentIndex

setCurrentIndex方法用于设置当前选中的下拉列表项的索引。

    void QComboBox::setCurrentIndex(int index);

其中index参数表示下拉列表项的索引，从0开始计数。

3. currentIndex

currentIndex属性用于获取当前选中的下拉列表项的索引。

    int QComboBox::currentIndex() const;

返回值为当前选中的下拉列表项的索引。

三、QComboBox事件处理

1. currentIndexChanged

currentIndexChanged信号会在当前选中项改变时发出，我们可以在该信号的槽函数中根据当前选中的下拉列表项做出相应的处理。

    connect(comboBox, QOverload::of(&QComboBox::currentIndexChanged),
            [=](int index) {
                qDebug() << "Current index changed to:" << index;
            });

  

以上代码的含义是在当前选中项改变时输出当前选中的下拉列表项的索引。

四、QComboBox进阶应用

1. 自定义下拉列表项

我们可以通过自定义QComboBox里的下拉列表项，来实现更加个性化的UI效果。我们可以通过QComboBox的setItemDelegate()方法设置委托，在委托中实现我们想要的样式。

下面是一个自定义下拉列表项的代码实例：

    class MyItemDelegate : public QStyledItemDelegate
    {
    public:
        using QStyledItemDelegate::QStyledItemDelegate;  // 使用父类的构造函数

        void paint(QPainter *painter, const QStyleOptionViewItem &option,
                   const QModelIndex &index) const override
        {
            if (option.state & QStyle::State_Selected) {
                painter->fillRect(option.rect, option.palette.highlight());
            }

            QRect rect = option.rect.adjusted(2, 2, -2, -2);
            painter->setBrush(Qt::NoBrush);
            painter->drawRect(rect);

            QString text = index.data(Qt::DisplayRole).toString();
            painter->drawText(rect, Qt::AlignCenter, text);
        }

        QSize sizeHint(const QStyleOptionViewItem &option,
                       const QModelIndex &index) const override
        {
            QFontMetrics fm(option.font);
            int w = fm.boundingRect(index.data(Qt::DisplayRole).toString())
                    .width() + 4;
            return QSize(w, fm.height() + 4);
        }
    };

    QComboBox *comboBox = new QComboBox;
    comboBox->addItem("Item 1");
    comboBox->addItem("Item 2");
    comboBox->setItemDelegate(new MyItemDelegate(comboBox));

以上代码的含义是实现自定义的下拉列表项，其中MyItemDelegate类继承自QStyledItemDelegate，重写了paint()和sizeHint()方法，来实现自定义下拉列表项的UI效果。在QComboBox控件中，我们通过setItemDelegate()方法来设置该委托，进而实现自定义下拉列表项的效果。

2. 绑定数据模型

我们可以通过绑定数据模型来动态更新下拉列表项，数据模型可以是QStandardItemModel、QSqlQueryModel、QSqlTableModel等。这里我们以QStandardItemModel为例。

下面是一个绑定QStandardItemModel的代码实例：

    QStandardItemModel *model = new QStandardItemModel;
    model->setColumnCount(1);

    QStandardItem *item;
    for (int i = 1; i <= 5; ++i) {
        item = new QStandardItem(tr("Item %1").arg(i));
        model->appendRow(item);
    }

    QComboBox *comboBox = new QComboBox;
    comboBox->setModel(model);

以上代码的含义是创建一个QStandardItemModel数据模型，然后在其中添加5个选项。接着创建一个QComboBox控件，并将该数据模型绑定到QComboBox控件上，即可实现动态更新下拉列表项的效果。

五、总结

以上就是Qt QComboBox控件的详细介绍和使用方法，QComboBox控件是界面设计中一个很常用的控件之一，在开发过程中也需要用到它。通过本文的介绍，相信读者们对QComboBox的使用已经有了更加深入的了解。