如何阻止QCompleter弹窗在关联QLineEdit文本变更时自动隐藏

需求是实现类似谷歌搜索栏的功能：QLineEdit文本变更时调用远程API，更新QCompleter的建议列表。当前存在以下问题：

• 文本输入后QCompleter弹窗自动隐藏，API返回结果更新模型后弹窗不会自动显示
• 调用completer.complete()虽能显示弹窗，但会因等待响应前的隐藏操作导致弹窗闪烁
• 重写事件过滤器仍存在闪烁，建议列表会在API回调更新模型前消失

解决方案核心思路 #

1. 阻止QCompleter默认自动隐藏行为：通过重写QCompleter的eventFilter，拦截导致弹窗隐藏的关键事件，避免文本输入时触发自动隐藏
2. 手动控制弹窗显示时机：在API回调更新模型后，根据当前输入状态决定是否显示弹窗，避免不必要的隐藏-显示循环
3. 添加请求防抖：避免频繁输入触发过多API请求，减少不必要的模型更新和弹窗操作

修改后的完整代码 #

from PySide6 import QtCore, QtWidgets
from __feature__ import snake_case, true_property  # noqa: F401

class CustomCompleter(QtWidgets.QCompleter):
    def __init__(self, parent=None):
        super().__init__(parent)
        self._should_keep_popup = False

    def set_should_keep_popup(self, keep):
        self._should_keep_popup = keep

    def eventFilter(self, obj, event):
        # 拦截导致弹窗隐藏的按键事件，仅在需要保持弹窗时生效
        if self._should_keep_popup and event.type() == QtCore.QEvent.Type.KeyPress:
            # 放行回车键、ESC键等特殊按键，不影响正常交互
            if event.key() not in (QtCore.Qt.Key.Key_Return, QtCore.Qt.Key.Key_Enter, 
                                  QtCore.Qt.Key.Key_Escape, QtCore.Qt.Key.Key_Tab):
                return True
        return super().eventFilter(obj, event)

class Window(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.main_widget = QtWidgets.QWidget(self)
        self.set_central_widget(self.main_widget)
        self.layout_ = QtWidgets.QVBoxLayout(self.main_widget)

        self.line_edit = QtWidgets.QLineEdit(self)
        self.layout_.add_widget(self.line_edit)

        self.completer_model = QtCore.QStringListModel(self)
        self.completer = CustomCompleter(self)
        self.completer.set_model(self.completer_model)
        self.line_edit.set_completer(self.completer)

        # 防抖定时器，避免频繁触发API请求
        self.debounce_timer = QtCore.QTimer(self)
        self.debounce_timer.set_single_shot(True)
        self.debounce_timer.timeout.connect(self._trigger_api_request)
        self.current_query = ""

        self.line_edit.textEdited.connect(self._on_text_edited)

    def _on_text_edited(self, query: str):
        self.current_query = query
        # 标记需要保持弹窗，阻止默认隐藏逻辑
        self.completer.set_should_keep_popup(True)
        # 启动防抖定时器，延迟触发API请求
        self.debounce_timer.start(300)

    def _trigger_api_request(self):
        # 模拟API请求，实际场景替换为真实网络请求逻辑
        QtCore.QTimer.single_shot(0, lambda: self._update_completer_suggestions(self.current_query))

    def _update_completer_suggestions(self, query):
        # 更新建议列表模型
        self.completer_model.set_string_list([f"{query}completedtext1", f"{query}completedtext2", f"{query}completedtext3"])
        # 恢复默认事件过滤逻辑
        self.completer.set_should_keep_popup(False)
        # 仅当输入框有内容且弹窗未显示时，手动触发弹窗
        if query and not self.completer.popup().is_visible():
            self.completer.complete()

app = QtWidgets.QApplication()
window = Window()
window.show()
app.exec()

代码关键点说明 #

• CustomCompleter：通过_should_keep_popup标记动态控制事件过滤，只在API请求过程中拦截导致弹窗隐藏的按键事件，不影响正常交互
• 防抖定时器：设置300ms延迟，过滤用户连续输入的中间状态，减少无效API请求和模型更新
• 弹窗显示控制：在模型更新完成后，根据当前输入状态判断是否需要显示弹窗，避免不必要的闪烁

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