如何实现QComboBox显示短值且下拉列表展示长值？

嘿，我来帮你搞定这个QComboBox的显示需求！你想要控件本身显示短值（比如'1'），下拉列表展开时显示对应的长文本（比如'Number One'），其实有两种简单靠谱的实现方式，刚好可以承接你已经写了一部分的双列模型代码：

方法一：双列模型 + 配置显示列（最直接） #

你已经在尝试创建双列模型了，只需要再补充两步配置，就能让控件和下拉列表分别显示不同列的内容：

#include <QComboBox>
#include <QStandardItemModel>
#include <QAbstractItemView>

// 你的原有代码基础上补全
QString max_dropdown_len = QString::number(300);
QString styleSheet = "QComboBox QAbstractItemView { min-width: %1; }";

QComboBox *cb = new QComboBox(this);
QStandardItemModel *model = qobject_cast<QStandardItemModel*>(cb->model());
if (!model) {
    // 如果默认模型不是QStandardItemModel，就新建一个
    model = new QStandardItemModel(cb);
    cb->setModel(model);
}
model->setColumnCount(2); // 列0存短值，列1存长文本

// 添加第一组项
QList<QStandardItem*> row1;
row1 << new QStandardItem("1") << new QStandardItem("Number One");
model->appendRow(row1);

// 添加第二组项
QList<QStandardItem*> row2;
row2 << new QStandardItem("2") << new QStandardItem("Number Two");
model->appendRow(row2);

// 添加第三组项
QList<QStandardItem*> row3;
row3 << new QStandardItem("3") << new QStandardItem("Number Three");
model->appendRow(row3);

// 核心配置1：让QComboBox控件本身显示列0的短值
cb->setModelColumn(0);

// 核心配置2：让下拉列表显示列1的长文本
QAbstractItemView *dropdownView = cb->view();
dropdownView->setModelColumn(1);
// 应用你之前设置的下拉宽度样式
cb->setStyleSheet(styleSheet.arg(max_dropdown_len));

原理说明： #

• 双列模型分别存储短值和长文本，通过setModelColumn(0)告诉QComboBox控件要渲染哪一列的内容；
• 下拉视图是独立的QAbstractItemView，通过setModelColumn(1)让它渲染长文本列；
• 最后用样式表设置下拉列表的最小宽度，避免长文本被截断。

方法二：单模型列 + 自定义数据角色（更灵活） #

如果你不想用双列模型，也可以给每个项绑定额外的长文本数据，通过自定义代理让下拉列表显示长文本：

#include <QComboBox>
#include <QStandardItemModel>
#include <QStyledItemDelegate>

// 定义一个自定义数据角色，用来存储长文本
const int LongTextRole = Qt::UserRole + 1;

// 自定义代理，让下拉列表显示长文本
class LongTextDelegate : public QStyledItemDelegate {
protected:
    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
        QStyleOptionViewItem opt = option;
        initStyleOption(&opt, index);
        // 把显示文本替换为自定义角色存储的长文本
        opt.text = index.data(LongTextRole).toString();
        QStyledItemDelegate::paint(painter, opt, index);
    }
};

// 创建并配置QComboBox
QComboBox *cb = new QComboBox(this);
QStandardItemModel *model = qobject_cast<QStandardItemModel*>(cb->model());
if (!model) {
    model = new QStandardItemModel(cb);
    cb->setModel(model);
}

// 添加项：displayRole存短值（控件显示），LongTextRole存长文本（下拉显示）
QStandardItem *item1 = new QStandardItem("1");
item1->setData("Number One", LongTextRole);
model->appendRow(item1);

QStandardItem *item2 = new QStandardItem("2");
item2->setData("Number Two", LongTextRole);
model->appendRow(item2);

QStandardItem *item3 = new QStandardItem("3");
item3->setData("Number Three", LongTextRole);
model->appendRow(item3);

// 给下拉视图设置自定义代理
cb->view()->setItemDelegate(new LongTextDelegate(cb));
// 设置下拉宽度
cb->view()->setMinimumWidth(300);

原理说明： #

• 利用Qt的多数据角色机制，给每个项同时存储短值（默认Qt::DisplayRole）和长文本（自定义角色）；
• 通过自定义QStyledItemDelegate重写paint方法，让下拉列表渲染自定义角色的长文本；
• 这种方式更适合后续需要扩展更多自定义数据的场景，不需要修改模型结构。

两种方法都能完美实现你的需求，你可以根据自己的代码结构选择合适的方式~

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