Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
CertFlow 文档
CertFlow 文档

使用指南

  • 快速开始
  • 配置体系
  • 操作者手册

操作流程

  • 04a 销售计划导入流程
  • 04b 查询与字段补充流程
  • 04b2 校正队列流程
  • 04c 编号流程
  • 04d 合格证生成与打印流程
  • 04e 报告生成流程
  • 04f 导出流程
  • 04g WebDAV 远程同步流程
  • 04h 基础字典维护
  • 04i 打印历史与发货归档

参考

  • 系统架构
  • CLI 命令参考
  • 开发者指南
  • 实现进度
  • 待办事项(TODO)

API 参考

  • certflow
    • certflow package
      • certflow.actions package
        • certflow.actions.registry module
      • certflow.cli package
        • certflow.cli.base_command module
      • certflow.config package
        • certflow.config.config_center_backend module
        • certflow.config.loader module
        • certflow.config.models module
        • certflow.config.paths_override module
        • certflow.config.print_config module
        • certflow.config.settings module
        • certflow.config.settings_ui module
        • certflow.config.ui_config module
      • certflow.controllers package
        • certflow.controllers.base_controller module
        • certflow.controllers.bom_material_controller module
        • certflow.controllers.caliber_mapping_controller module
        • certflow.controllers.certificate_controller module
        • certflow.controllers.correction_queue_controller module
        • certflow.controllers.history_controller module
        • certflow.controllers.import_controller module
        • certflow.controllers.material_grade_controller module
        • certflow.controllers.model_param_mapping_controller module
        • certflow.controllers.output_controller module
        • certflow.controllers.print_queue_controller module
        • certflow.controllers.printer_controller module
        • certflow.controllers.query_controller module
        • certflow.controllers.report_controller module
        • certflow.controllers.scan_controller module
        • certflow.controllers.settings_controller module
      • certflow.handlers package
        • certflow.handlers.csv_export module
        • certflow.handlers.data_cleaner module
        • certflow.handlers.excel_handler module
        • certflow.handlers.excel_styler module
        • certflow.handlers.id_generator module
        • certflow.handlers.report_generator module
        • certflow.handlers.save_handler module
        • certflow.handlers.scan_handler module
        • certflow.handlers.shipped_export_handler module
        • certflow.handlers.sorter module
        • certflow.handlers.styled_excel_importer module
        • certflow.handlers.template_handler module
      • certflow.services package
        • certflow.services.printer package
          • certflow.services.printer.escp_commands module
          • certflow.services.printer.lq635kii_printer module
          • certflow.services.printer.print_queue module
          • certflow.services.printer.print_strategy module
          • certflow.services.printer.printer_service module
          • certflow.services.printer.template_field_formatter module
          • certflow.services.printer.template_manager module
        • certflow.services.report_migration package
          • certflow.services.report_migration.material_provider module
          • certflow.services.report_migration.report_fill_engine module
          • certflow.services.report_migration.report_template_spec module
        • certflow.services.bom_material_service module
        • certflow.services.bom_part_classifier module
        • certflow.services.caliber_mapping_service module
        • certflow.services.cert_export_service module
        • certflow.services.cert_log_service module
        • certflow.services.cert_numbering module
        • certflow.services.cert_numbering_policy module
        • certflow.services.cert_print_engine module
        • certflow.services.certificate_number_service module
        • certflow.services.certificate_print_service module
        • certflow.services.certificate_service module
        • certflow.services.correction_queue_service module
        • certflow.services.db_source_adapter module
        • certflow.services.dict_csv_sync module
        • certflow.services.dn_service module
        • certflow.services.dual_code module
        • certflow.services.import_gate_service module
        • certflow.services.material_grade_service module
        • certflow.services.model_param_mapping_service module
        • certflow.services.model_spec_parser module
        • certflow.services.output_guard module
        • certflow.services.pn_service module
        • certflow.services.pressure_calc_service module
        • certflow.services.print_history_service module
        • certflow.services.printer_manager module
        • certflow.services.query_builder module
        • certflow.services.query_service module
        • certflow.services.report_bom_enricher module
        • certflow.services.report_fill_service module
        • certflow.services.report_output_service module
        • certflow.services.sale_plan_service module
        • certflow.services.scan_service module
        • certflow.services.workflow_service module
      • certflow.utils package
        • certflow.utils.access_db module
        • certflow.utils.database module
        • certflow.utils.date_utils module
        • certflow.utils.id_generator module
        • certflow.utils.logger module
        • certflow.utils.path_utils module
        • certflow.utils.retry module
        • certflow.utils.status_inference module
      • certflow.views package
        • certflow.views.bases package
          • certflow.views.bases.datasources package
            • certflow.views.bases.datasources.base_data module
            • certflow.views.bases.datasources.bom_query module
            • certflow.views.bases.datasources.correction module
            • certflow.views.bases.datasources.sale_plan module
          • certflow.views.bases.base_dialog module
          • certflow.views.bases.base_query_view module
          • certflow.views.bases.base_view module
          • certflow.views.bases.lookup_table_manager_view module
          • certflow.views.bases.query_data_source module
        • certflow.views.common package
          • certflow.views.common.i18n_manager module
          • certflow.views.common.qdate_utils module
          • certflow.views.common.theme_manager module
        • certflow.views.base_data_hub_widget module
        • certflow.views.bom_import_widget module
        • certflow.views.bom_material_query_view module
        • certflow.views.caliber_mapping_manager_view module
        • certflow.views.certificate_preview_painter module
        • certflow.views.correction_flag_query_view module
        • certflow.views.correction_queue_view module
        • certflow.views.history_view module
        • certflow.views.import_confirm_dialog module
        • certflow.views.import_dialog module
        • certflow.views.import_page module
        • certflow.views.lookup_tables_dialog module
        • certflow.views.main_window module
        • certflow.views.material_grade_manager_view module
        • certflow.views.model_param_mapping_manager_view module
        • certflow.views.output_view module
        • certflow.views.param_supplement_dialog module
        • certflow.views.print_dialog module
        • certflow.views.print_view module
        • certflow.views.query_hub_view module
        • certflow.views.query_view module
        • certflow.views.queue_panel module
        • certflow.views.report_view module
        • certflow.views.sale_plan_query_view module
        • certflow.views.scan_view module
        • certflow.views.settings_view module
      • certflow.widgets package
        • certflow.widgets.button_row module
        • certflow.widgets.confirm_dialog module
        • certflow.widgets.data_table module
        • certflow.widgets.dialog_button_bar module
        • certflow.widgets.enhanced_table module
        • certflow.widgets.filter_bar module
        • certflow.widgets.filter_row module
        • certflow.widgets.flow_layout module
        • certflow.widgets.quick_search module
        • certflow.widgets.quick_search_preset module
        • certflow.widgets.section_card module
      • certflow.bootstrap module
      • certflow.main module
Back to top
View this page

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

可编辑模糊匹配快查框。

参数:
  • placeholder (str)

  • min_width (int)

typing¶
activated¶
set_items(items)[源代码]¶

填充候选项(editable + completer 模糊匹配),并清空当前输入。

参数:

items (list[str])

返回类型:

None

staticMetaObject = PySide6.QtCore.QMetaObject("QuickSearch" inherits "QComboBox": Methods:   #46 type=Signal, signature=typing(QString), parameters=QString   #47 type=Signal, signature=activated(QString), parameters=QString )¶
Next
certflow.widgets.quick_search_preset module
Previous
certflow.widgets.flow_layout module
Copyright © 2026, CertFlow
Made with Sphinx and @pradyunsg's Furo
On this page
  • certflow.widgets.quick_search module
    • QuickSearch
      • QuickSearch.typing
      • QuickSearch.activated
      • QuickSearch.set_items()
      • QuickSearch.staticMetaObject