持久化排序选择QComboBox-QCompleter弹出框技术实现问询

我来帮你拆解这个需求的实现步骤，核心就是搞定多选ComboBox的状态暴露、委托与表格模型的交互、选中项的存储与展示这几个关键点，一步步来：

1. 先让你的多选ComboBox能"说清楚"自己选了啥 #

你的自定义QComboBox（就叫它MultiSelectComboBox吧）得有能力对外提供当前选中的项列表，还要在用户修改选择时主动通知外部，这样委托和表格模型才能跟上变化。

给你的MultiSelectComboBox加几个关键方法和信号：

class MultiSelectComboBox : public QComboBox
{
    Q_OBJECT
public:
    explicit MultiSelectComboBox(QWidget *parent = nullptr);
    
    // 获取选中项的实际数据（比如你存在Qt::UserRole里的ID/标识）
    QList<QVariant> getSelectedValues() const;
    // 从外部设置选中项，用于表格初始化时回显已选内容
    void setSelectedValues(const QList<QVariant>& values);

signals:
    // 选中状态变化时触发，把新的选中列表传出去
    void selectionUpdated(const QList<QVariant>& selectedItems);

private slots:
    // 监听底层列表模型的勾选状态变化
    void onModelCheckedStateChanged(const QModelIndex& topLeft, const QModelIndex& bottomRight);
};

实现部分要处理模型的状态变化，并且正确读取/设置勾选状态：

MultiSelectComboBox::MultiSelectComboBox(QWidget *parent) : QComboBox(parent)
{
    // 监听底层列表模型的数据变化（因为勾选状态存在模型里）
    connect(model(), &QAbstractItemModel::dataChanged, this, &MultiSelectComboBox::onModelCheckedStateChanged);
}

void MultiSelectComboBox::onModelCheckedStateChanged(const QModelIndex& topLeft, const QModelIndex& bottomRight)
{
    // 只要勾选状态变了，就发出信号通知外部
    emit selectionUpdated(getSelectedValues());
}

QList<QVariant> MultiSelectComboBox::getSelectedValues() const
{
    QList<QVariant> selected;
    auto listModel = qobject_cast<QAbstractListModel*>(this->model());
    if (!listModel) return selected;
    
    // 遍历模型，把勾选的项的UserRole数据收集起来
    for (int i = 0; i < listModel->rowCount(); ++i) {
        QModelIndex idx = listModel->index(i, 0);
        if (idx.data(Qt::CheckStateRole).toInt() == Qt::Checked) {
            selected.append(idx.data(Qt::UserRole));
        }
    }
    return selected;
}

void MultiSelectComboBox::setSelectedValues(const QList<QVariant>& values)
{
    auto listModel = qobject_cast<QAbstractListModel*>(this->model());
    if (!listModel) return;
    
    // 根据传入的列表设置模型的勾选状态
    for (int i = 0; i < listModel->rowCount(); ++i) {
        QModelIndex idx = listModel->index(i, 0);
        bool isChecked = values.contains(idx.data(Qt::UserRole));
        listModel->setData(idx, isChecked ? Qt::Checked : Qt::Unchecked, Qt::CheckStateRole);
    }
}

2. 用自定义委托把ComboBox和表格模型绑起来 #

你的QItemDelegate子类（叫MultiSelectDelegate）要负责创建编辑器、初始化编辑器的选中状态，还要把用户的选择同步回表格模型，同时生成展示用的字符串。

代码实现如下：

class MultiSelectDelegate : public QItemDelegate
{
    Q_OBJECT
public:
    explicit MultiSelectDelegate(QWidget *parent = nullptr);

    // 创建编辑器：返回你的多选ComboBox
    QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
    // 初始化编辑器：从表格模型读取已存的选中项
    void setEditorData(QWidget *editor, const QModelIndex &index) const override;
    // 把编辑器的选择同步回模型：同时存原始列表和展示字符串
    void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override;
};

委托的核心逻辑：

QWidget *MultiSelectDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    auto combo = new MultiSelectComboBox(parent);
    // 这里记得给combo设置你的自定义QAbstractListModel实例
    // combo->setModel(new YourCustomListModel(combo));
    
    // 绑定选中变化信号，实时同步到表格模型（也可以等下拉框关闭再同步，看你的需求）
    connect(combo, &MultiSelectComboBox::selectionUpdated, this, [=]() {
        commitData(combo); // 触发setModelData方法
    });
    return combo;
}

void MultiSelectDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    auto combo = qobject_cast<MultiSelectComboBox*>(editor);
    if (!combo) return;
    
    // 从表格模型的EditRole读取已存的选中项列表，设置给ComboBox
    QList<QVariant> savedSelected = index.data(Qt::EditRole).value<QList<QVariant>>();
    combo->setSelectedValues(savedSelected);
}

void MultiSelectDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    auto combo = qobject_cast<MultiSelectComboBox*>(editor);
    if (!combo || !model) return;
    
    // 1. 把选中项的原始列表存到表格模型的EditRole（供后续回显用）
    QList<QVariant> selectedValues = combo->getSelectedValues();
    model->setData(index, QVariant::fromValue(selectedValues), Qt::EditRole);
    
    // 2. 生成展示用的字符串，存到DisplayRole（表格单元格显示用）
    QString displayStr;
    auto listModel = qobject_cast<QAbstractListModel*>(combo->model());
    if (listModel) {
        QStringList displayTexts;
        // 根据选中的原始数据，找到对应的显示文本
        for (const auto& val : selectedValues) {
            for (int i = 0; i < listModel->rowCount(); ++i) {
                QModelIndex idx = listModel->index(i, 0);
                if (idx.data(Qt::UserRole) == val) {
                    displayTexts.append(idx.data(Qt::DisplayRole).toString());
                    break;
                }
            }
        }
        displayStr = displayTexts.join(", "); // 用逗号分隔展示
    }
    model->setData(index, displayStr, Qt::DisplayRole);
}

3. 调整表格模型支持存储选中项列表 #

你的QAbstractTableModel子类需要能存储QList<QVariant>类型的数据，并且在data()方法里正确返回编辑用的列表和展示用的字符串：

假设你的表格数据存在一个自定义结构体里，比如：

struct TableRowData {
    QList<QVariant> selectedItems; // 存选中项的原始数据
    QString displayText; // 存展示用的字符串
    // 其他字段...
};

然后模型的data()和setData()方法这样实现：

QVariant YourTableModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid()) return QVariant();
    
    const TableRowData& rowData = m_tableRows[index.row()];
    if (role == Qt::DisplayRole) {
        // 返回展示字符串
        return rowData.displayText;
    } else if (role == Qt::EditRole) {
        // 返回选中项列表，供编辑器回显
        return QVariant::fromValue(rowData.selectedItems);
    }
    // 其他角色的处理（比如对齐、字体等）...
    return QVariant();
}

bool YourTableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (!index.isValid()) return false;
    
    TableRowData& rowData = m_tableRows[index.row()];
    if (role == Qt::EditRole) {
        rowData.selectedItems = value.value<QList<QVariant>>();
    } else if (role == Qt::DisplayRole) {
        rowData.displayText = value.toString();
    }
    
    emit dataChanged(index, index);
    return true;
}

4. 最后一步：给表格视图绑定委托 #

在你的主窗口里，把这个委托设置给表格的目标列就行：

auto multiSelectDelegate = new MultiSelectDelegate(this);
// 假设你要在第2列使用这个多选ComboBox（索引从0开始）
ui->yourTableView->setItemDelegateForColumn(1, multiSelectDelegate);

• 你的自定义列表模型（给ComboBox用的）一定要正确实现Qt::CheckStateRole的读写，这样勾选状态才能被正确保存和读取。
• 如果不想实时同步选中状态，而是等用户关闭下拉框再同步，可以把委托里的信号绑定改成QComboBox::hidePopup()信号，这样更符合传统ComboBox的交互逻辑。
• 展示字符串的生成也可以放到表格模型里，比如在setData处理EditRole时自动生成，这样委托的逻辑会更简洁，看你自己的架构偏好。

内容的提问来源于stack exchange，提问作者user20679