GUI 基础类 (quatmQt)
BWidget、BMainWindow、BFrame——带几何持久化和属性通信的 Qt 基类。
概述
quatmQt.py 定义了所有 Quatm GUI 组件的基类，提供窗口几何持久化和 Properties 通信总线。
类层次
QWidget → BWidget
QFrame → BFrame
QMainWindow → BMainWindow
BWidget — 基础 Widget
from quatm.GUI.quatmQt import BWidget
widget = BWidget(name="my_widget", parent=None)
| 特性 | 说明 |
|---|---|
| 几何持久化 | 通过 QSettings 自动保存/恢复位置和大小 |
| 属性通信 | 每个实例自动关联 Properties 实例 |
| 命名空间 | name 参数用于 QSettings 键和日志标识 |
BMainWindow — 主窗口基类
from quatm.GUI.quatmQt import BMainWindow
window = BMainWindow(name="MainWindow", parent=None)
window.setWindowTitle("Quatm")
除 BWidget 的全部特性外，还管理窗口标题和菜单栏。
CustomCompleter
from quatm.GUI.quatmQt import CustomCompleter
completer = CustomCompleter(items, parent)
completer.setFilterMode("contains") # 或 "begins"
带 contains / begins 匹配模式的下拉自动补全组件，用于搜索框和命令输入。