You need to enable JavaScript to run this app. 如何在QListView中为每一行显示对应的行索引序号?
优惠活动
大模型
产品
解决方案
定价
更多

如何在QListView中为每一行显示对应的行索引序号?

QListView添加行索引序号实现方案

方案1:静态拼接序号(适合数据固定场景)

直接修改遍历逻辑,填充item时将序号拼接至显示文本即可,修改后代码如下:

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStandardItem, QStandardItemModel

model = QStandardItemModel()
self.listView.setModel(model)

results = {'D2_SMI_1': True, 'D2_SMI_2': False}

# start参数控制序号起始值,可根据需求调整
for idx, (key, value) in enumerate(results.items(), start=1):
    # 序号显示格式可自定义,比如f"{idx:02d}. {key}"实现两位数字补零
    display_text = f"{idx}. {key}"
    item = QStandardItem(display_text)
    item.setCheckable(True)
    # 布尔值转Qt原生CheckState枚举,避免类型兼容报错
    item.setCheckState(Qt.Checked if value else Qt.Unchecked)
    model.appendRow(item)

该方案改造成本极低,缺点是如果后续有行增删操作,需要手动更新所有后续行的序号。

方案2:动态自动更新序号(适合数据动态变化场景)

如果后续需要新增、删除、插入行,可通过绑定model的行变更信号自动刷新所有行的序号,同时将原始key存储在自定义角色中避免解析文本:

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStandardItem, QStandardItemModel

model = QStandardItemModel()
self.listView.setModel(model)

# 定义序号刷新函数
def refresh_row_numbers():
    for row in range(model.rowCount()):
        item = model.item(row)
        # 从自定义角色取出原始key
        origin_key = item.data(Qt.UserRole)
        item.setText(f"{row+1}. {origin_key}")

# 绑定行变更信号,增删行自动触发序号刷新
model.rowsInserted.connect(refresh_row_numbers)
model.rowsRemoved.connect(refresh_row_numbers)

results = {'D2_SMI_1': True, 'D2_SMI_2': False}
for key, value in results.items():
    item = QStandardItem()
    # 原始key存入自定义角色,避免和显示文本耦合
    item.setData(key, Qt.UserRole)
    item.setCheckable(True)
    item.setCheckState(Qt.Checked if value else Qt.Unchecked)
    model.appendRow(item)

# 初始化时刷新一次序号
refresh_row_numbers()

该方案不需要手动维护序号,任何行数量变化都会自动同步更新。

方案3:委托绘制序号(推荐,无侵入)

如果不想修改item的原始文本,后续调用item.text()可以直接拿到原key,可以通过自定义委托在绘制时动态生成序号,完全不侵入model数据:

from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QStyledItemDelegate

# 自定义绘制委托
class NumberDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        # 原内容向右偏移25px预留序号位置
        option.rect.adjust(25, 0, 0, 0)
        super().paint(painter, option, index)
        # 绘制左侧序号
        painter.drawText(option.rect.adjusted(-25, 0, 0, 0), Qt.AlignVCenter | Qt.AlignLeft, str(index.row()+1))

# 给listView设置委托
self.listView.setItemDelegate(NumberDelegate(self.listView))

# 原有业务逻辑完全不用修改
model = QStandardItemModel()
self.listView.setModel(model)
results = {'D2_SMI_1': True, 'D2_SMI_2': False}
for key, value in results.items():
    item = QStandardItem(key)
    item.setCheckable(True)
    item.setCheckState(Qt.Checked if value else Qt.Unchecked)
    model.appendRow(item)

该方案序号是绘制时根据行号实时计算的,增删行自动同步,完全不修改原有数据逻辑。

注意:原有代码直接将布尔值传入setCheckState可能存在类型兼容问题,Qt要求传入Qt.Checked/Qt.Unchecked枚举值,建议按示例做转换避免报错。

内容的提问来源于stack exchange,提问作者Nikko

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 09:24:00