PyQt5中如何限制QCompleter下拉列表的显示行数
PyQt5 限制QCompleter下拉列表显示行数的实现方案
核心实现逻辑
QCompleter的下拉弹窗本质是内置的QListView控件,不需要重写匹配规则、不需要自定义补全模型,只要直接约束弹窗的最大高度,就能实现固定行数的显示效果:
- 匹配结果数量小于设定的行数上限时,弹窗高度自动适配全部内容
- 匹配结果数量超过设定的行数上限时,弹窗内部自动生成垂直滚动条,仅展示指定行数的内容
实现步骤
- 初始化QCompleter实例后,调用
popup()方法获取内置的下拉列表对象 - 给列表开启
setUniformItemSizes(True)优化,统一行高计算规则,避免尺寸偏差 - 绑定列表模型的行数变化信号,每次匹配结果更新时,根据设定的最大行数计算弹窗允许的最大高度
可直接运行的完整测试代码
from PyQt5.QtWidgets import * import sys class Window(QWidget): def __init__(self): super().__init__() layout = QGridLayout() self.setLayout(layout) names = ["Apple", "Alps", "August", "Alpha", "Ate", "ABerry", "Cherry" ] completer = QCompleter(names, self) # 下拉行数限制逻辑 popup_listview = completer.popup() popup_listview.setUniformItemSizes(True) # *可根据需求修改该值,控制最大可见行数* MAX_VISIBLE_ROWS = 3 def update_popup_height(): model = popup_listview.model() if model.rowCount() > 0: # 获取单行实际渲染高度 first_row_index = model.index(0, 0) single_row_height = popup_listview.visualRect(first_row_index).height() # 计算弹窗最大高度,加2像素抵消列表边框的尺寸偏差 popup_listview.setMaximumHeight(single_row_height * MAX_VISIBLE_ROWS + 2) # 匹配结果变动时自动刷新弹窗高度 popup_listview.model().rowsInserted.connect(update_popup_height) popup_listview.model().rowsRemoved.connect(update_popup_height) self.lineedit = QLineEdit() self.lineedit.setCompleter(completer) layout.addWidget(self.lineedit, 0, 0) app = QApplication(sys.argv) screen = Window() screen.show() sys.exit(app.exec_())
注意事项
- 不要在初始化阶段硬编码弹窗高度,此时列表还未完成行高渲染,直接赋值会出现尺寸偏差;绑定模型行数变化信号后,会在匹配结果首次生成时自动计算准确高度
- 若需要自定义每行的显示高度,只需给弹窗设置自定义的
itemDelegate,用实际渲染的行高代入计算逻辑即可,不需要改动其他代码 - 该方案兼容QCompleter的所有内置匹配模式,不会触发自定义模型相关的报错
内容的提问来源于stack exchange,提问作者user14993843
相关产品推荐
相关产品推荐

