You need to enable JavaScript to run this app. PyQt5中如何限制QCompleter下拉列表的显示行数
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 11:15:04