Windows系统下QListView的ElideRight文本省略功能生效异常问题

问题背景 #

我同时在Windows与Linux两款操作系统下开展开发工作，遇到QListView文本省略功能跨平台表现不一致的问题：Linux环境下Qt::ElideRight右省略模式运行正常，但Windows环境下该模式无法正常生效，显示效果不符合预期。
设置文本省略模式的代码如下：

ui->geometry_list->setTextElideMode(Qt::ElideRight);

相关效果参考：

• Linux端列表运行效果：
• Windows端列表运行效果：

修复方案 #

该差异由Qt不同平台下的默认控件属性、文本计算逻辑差异导致，可按以下步骤逐一修复：

1. 显式关闭自动换行属性
   Windows下部分Qt版本的QListView会默认优先尝试换行显示文本，覆盖省略模式的生效逻辑，在设置省略模式的代码后新增一行即可：

ui->geometry_list->setWordWrap(false);

2. 开启列表项统一大小约束
   不同平台下控件边距计算逻辑不同，会导致文本可用宽度判定异常，开启统一项大小后Qt会使用固定宽度计算省略位置，消除平台差异：

ui->geometry_list->setUniformItemSizes(true);

3. 自定义绘制代理（仅适用于重写了ItemDelegate的场景）
   如果自定义了列表项绘制逻辑，需要手动调用文本省略方法生成符合要求的文本，避免Windows下默认绘制逻辑跳过省略计算：

void CustomDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QStyleOptionViewItem opt = option;
    initStyleOption(&opt, index);
    // 手动生成右省略文本
    QString elidedText = opt.fontMetrics.elidedText(opt.text, Qt::ElideRight, opt.rect.width());
    opt.text = elidedText;
    QStyledItemDelegate::paint(painter, opt, index);
}

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