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 appendRow(item);
    }

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

以上代碼的含義是創建一個QStandardItemModel數據模型，然後在其中添加5個選項。接著創建一個QComboBox控制項，並將該數據模型綁定到QComboBox控制項上，即可實現動態更新下拉列表項的效果。

五、總結

以上就是Qt QComboBox控制項的詳細介紹和使用方法，QComboBox控制項是界面設計中一個很常用的控制項之一，在開發過程中也需要用到它。通過本文的介紹，相信讀者們對QComboBox的使用已經有了更加深入的了解。