PyQt5自定义可过滤ComboBox无精确匹配时高亮首个结果问题求解

问题原因 #

现有代码存在两个核心配置缺漏：

• 默认QSortFilterProxyModel和QCompleter仅匹配前缀开头的字符串，无法匹配选项中间的子串
• 输入内容过滤完成后没有主动触发第一个匹配项的选中逻辑

修改步骤 #

1. 调整过滤规则，允许匹配字符串任意位置的子串，保留大小写不敏感的配置
2. 新增文本变更处理槽函数，过滤完成后自动选中第一个匹配结果

完整修改后代码 #

import sys
from PyQt5.Qt import Qt
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *

class ExtendedComboBox(QComboBox):
    def __init__(self, parent=None):
        super(ExtendedComboBox, self).__init__(parent)

        self.setFocusPolicy(Qt.StrongFocus)
        self.setEditable(True)
        self.view().setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)

        # 过滤模型配置
        self.pFilterModel = QSortFilterProxyModel(self)
        self.pFilterModel.setFilterCaseSensitivity(Qt.CaseInsensitive)
        # 新增：允许匹配任意位置子串
        self.pFilterModel.setFilterMatchFlags(Qt.MatchContains)
        self.pFilterModel.setSourceModel(self.model())

        # 补全器配置
        self.completer = QCompleter(self.pFilterModel, self)
        # 新增：补全器允许匹配任意位置子串
        self.completer.setFilterMode(Qt.MatchContains)
        self.completer.setCompletionMode(QCompleter.UnfilteredPopupCompletion)
        self.setCompleter(self.completer)

        # 信号连接：修改为绑定自定义处理槽
        self.lineEdit().textEdited.connect(self.on_text_edited)
        self.completer.activated.connect(self.on_completer_activated)

    # 新增：文本变更处理逻辑
    def on_text_edited(self, text):
        # 更新过滤规则
        self.pFilterModel.setFilterFixedString(text)
        if not text:
            return
        # 弹出匹配列表
        self.completer.complete()
        # 存在匹配项时自动选中第一个
        if self.completer.completionCount() > 0:
            first_match_index = self.completer.completionModel().index(0, 0)
            self.completer.popup().setCurrentIndex(first_match_index)

    # 补全项选中逻辑
    def on_completer_activated(self, text):
        if text:
            index = self.findText(text)
            self.setCurrentIndex(index)
            self.activated[str].emit(self.itemText(index))

    # 模型更新同步
    def setModel(self, model):
        super(ExtendedComboBox, self).setModel(model)
        self.pFilterModel.setSourceModel(model)
        self.completer.setModel(self.pFilterModel)

    # 模型列更新同步
    def setModelColumn(self, column):
        self.completer.setCompletionColumn(column)
        self.pFilterModel.setFilterKeyColumn(column)
        super(ExtendedComboBox, self).setModelColumn(column)
        
class Application(QWidget):
    def __init__(self):
        super().__init__()
        items = set(
            "You can use QCompleter to provide auto completions in any Qt widget, such as QLineEdit and QComboBox. When the user starts typing a word, QCompleter suggests possible ways of completing the word, based on a word list.".split(
                ' '))
        layout = QVBoxLayout(self)
        cb = ExtendedComboBox(self)
        cb.addItems(items)
        cb.setCurrentText("")
        layout.addWidget(cb)
        layout.addStretch(1)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    diag = Application()
    diag.show()
    sys.exit(app.exec_())

低版本Qt兼容方案 #

如果你的Qt版本低于5.10不支持setFilterMatchFlags方法，可以将on_text_edited方法修改为正则实现的版本，效果完全一致：

def on_text_edited(self, text):
    # 转义特殊字符避免正则解析错误
    escaped_text = QRegularExpression.escape(text)
    regex = QRegularExpression(escaped_text, QRegularExpression.CaseInsensitiveOption)
    self.pFilterModel.setFilterRegularExpression(regex)
    if not text:
        return
    self.completer.complete()
    if self.completer.completionCount() > 0:
        first_match_index = self.completer.completionModel().index(0, 0)
        self.completer.popup().setCurrentIndex(first_match_index)

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