certflow.widgets.quick_search module¶
可复用快查框控件(公共 widgets 模块)。
从 import_dialog.order_quick_search 与 FilterBar 内联快查框抽取为独立控件,
统一「editable + completer 模糊匹配」交互(§1.7 收益:导入快查框可复用到已导入库查询)。
与快查逻辑 certflow.widgets.quick_search_preset.QuickSearchPresetMixin 同处
widgets/ 包,做到「控件 + 逻辑」语义聚拢。
设计要点: - 数据源无关:仅负责「去重候选项 → 模糊匹配 → 选中转发」交互,候选数据由宿主提供。 - 双信号(动态搜索模式切换):
typing:用户在输入框键入(真实输入、非程序赋值)时发出,携带当前文本。 驱动「模糊匹配模式」——下拉由 completer 做模糊初步筛选,宿主再做防抖的初步数据筛 选。程序化的set_items/setCurrentText不会触发,避免噪声。
activated:用户点击/回车**选中某个具体条目**时发出(对齐QComboBox.textActivated的 QString 重载,避开activated(int)默认重载收到索引 的坑),驱动「精确匹配模式」——按字段逐段精确回填并查询。
- class certflow.widgets.quick_search.QuickSearch(parent=None, *, placeholder='', min_width=260, filter_mode=<MatchFlag.MatchContains: 1>)[源代码]¶
基类:
QComboBox可编辑模糊匹配快查框。
- typing¶
- activated¶
- staticMetaObject = PySide6.QtCore.QMetaObject("QuickSearch" inherits "QComboBox": Methods: #46 type=Signal, signature=typing(QString), parameters=QString #47 type=Signal, signature=activated(QString), parameters=QString )¶