QObject的详细解说

1. QObject 父类解说

QObject 是 Qt 框架中所有对象的基类，提供以下核心功能：

• 父子对象树管理
  子对象可通过 setParent() 或构造函数指定父对象，父对象删除时会自动销毁所有子对象。

  parent = QObject()
  child = QObject(parent)  # 直接指定父对象
  

• 对象名称和属性
  支持通过 setObjectName() 设置唯一标识符，便于调试和样式表操作。

  obj = QObject()
  obj.setObjectName("myObject")
  

• 信号与槽机制
  允许对象间通过信号（Signal）和槽（Slot）进行松耦合通信。

  class MyObject(QObject):
      # 定义一个信号
      my_signal = Signal(str)
  
      def trigger_signal(self):
          self.my_signal.emit("Hello!")
  

• 事件处理
  提供 event() 方法处理通用事件（如定时器、鼠标键盘事件）。

• 内存管理
  基于父子关系的自动内存回收机制（需避免循环引用）。

---

2. QObject 子类解说

自定义类继承 QObject 时需注意以下要点：

• 必须调用父类构造函数
  使用 super().__init__() 确保父类初始化。

  class MyClass(QObject):
      def __init__(self, parent=None):
          super().__init__(parent)  # 必须调用父类构造函数
  

• 添加信号和槽
  通过 Signal 和 Slot 装饰器定义。

  class MySubclass(QObject):
      # 定义一个带参数的信号
      data_ready = Signal(int, str)
  
      # 定义一个槽函数
      @Slot()
      def handle_data(self):
          print("Data received!")
  

• 动态属性
  可通过 setProperty() 和 property() 管理动态属性。

  obj = QObject()
  obj.setProperty("priority", 10)
  print(obj.property("priority"))  # 输出 10
  

---

3. 代码实例

示例 1：父子对象与生命周期

from PySide6.QtCore import QObject

# 创建父对象
parent = QObject()
parent.setObjectName("ParentObject")

# 创建两个子对象
child1 = QObject(parent)
child1.setObjectName("Child1")

child2 = QObject()
child2.setParent(parent)  # 另一种指定父对象的方式
child2.setObjectName("Child2")

# 遍历子对象
for child in parent.children():
    print(child.objectName())  # 输出 Child1 和 Child2

# 删除父对象时，子对象自动销毁
del parent  # Child1 和 Child2 也会被删除

示例 2：自定义信号与槽

from PySide6.QtCore import QObject, Signal, Slot

class Sender(QObject):
    # 定义一个带参数的信号
    message_sent = Signal(str)

class Receiver(QObject):
    @Slot(str)
    def handle_message(self, msg):
        print(f"Received: {msg}")

sender = Sender()
receiver = Receiver()

# 连接信号与槽
sender.message_sent.connect(receiver.handle_message)

# 触发信号
sender.message_sent.emit("Hello from Python!")
# 输出: Received: Hello from Python!

示例 3：对象查找与动态属性

class Device(QObject):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setProperty("status", "offline")

hub = QObject()
device1 = Device(hub)
device2 = Device(hub)

# 通过对象名查找子对象
device1.setObjectName("DeviceA")
found_device = hub.findChild(QObject, "DeviceA")
print(found_device.property("status"))  # 输出 offline

# 动态修改属性
device1.setProperty("status", "online")

---

关键总结

• 父子关系：简化内存管理，避免内存泄漏
• 信号槽：实现对象间解耦通信
• 元对象系统：支持动态属性、反射等高级特性
• 事件处理：可通过重写 event() 实现自定义行为

在 Python 中使用时需注意：PySide6/PyQt6 会自动处理对象生命周期，但仍建议显式设置父子关系以确保符合预期行为。