GUI 基础类

BWidget、BMainWindow、BFrame：带几何持久化和属性通信的 Qt 基类。

概述

quatm/GUI/widgets/quatmQt.py 定义了 Quatm 图形界面各组件的基类与常用控件：提供窗口几何持久化、Properties 属性命名空间，以及带补全的下拉框等。

类层次

QWidget  → BWidget
QFrame   → BFrame
QMainWindow → BMainWindow

基类与混入

组件	说明
`GeometrySaveMixin`	把窗口几何持久化到 `QSettings`（按窗口名分键）；关闭、移动、缩放时（防抖）保存
`BWidget`	Quatm 控件基类：带 `Properties` 命名空间与几何持久化
`BFrame`	对应 `QFrame` 的基类，行为同 `BWidget`
`BMainWindow`	带几何持久化与属性句柄的主窗口基类

from quatm.GUI.widgets.quatmQt import BWidget, BMainWindow

widget = BWidget(name="my_widget", parent=None)
window = BMainWindow(name="MainWindow", parent=None)

搜索与补全控件

组件	说明
`CustomCompleter`	带匹配模式的补全器（`contains` 前缀包含 / `begins` 前缀开头）
`SearchComboBox`	启用自动补全、可输入搜索的下拉框；`add_if_new()` / `find_or_add()` 便捷维护条目
`SearchLineEdit`	供搜索框使用的编辑框：聚焦全选、失焦/回车记录、Escape 还原

from quatm.GUI.widgets.quatmQt import SearchComboBox

box = SearchComboBox(parent=parent)
box.add_if_new("my_stream")