PyQT中pyqtProperty()的使用方法与示例

在PyQt中，pyqtProperty()用于声明一个属性，并将其与一个getter和/或setter方法相关联。使用pyqtProperty()可以使我们在属性的读取和设置时，像操作常规属性一样进行操作。

下面是pyqtProperty()的基本语法：

pyqtProperty(type, fget=None, fset=None, freset=None, doc=None[, designable=True[, user=True[, notify=None[, scriptable=None[, stored=None]]]]])

参数说明：

- type：属性的类型，可以是int、str、bool等；

- fget：getter函数，用于获取属性值；

- fset：setter函数，用于设置属性值；

- freset：reset函数，用于重置属性值；

- doc：属性的文档字符串；

- designable：指定属性是否可以在设计器中编辑，默认为True；

- user：指定属性是否可以被用户编辑，默认为True；

- notify：当属性值发生变化时，要通知的信号；

- scriptable：指定属性是否可在脚本中使用，默认为None；

- stored：指定属性是否需要存储值，默认为None。

下面是一个示例，演示了如何使用pyqtProperty()声明一个属性：

from PyQt5.QtCore import QObject, pyqtProperty

class Person(QObject):
    def __init__(self, name=''):
        super().__init__()
        self._name = name

    @pyqtProperty(str)
    def name(self):
        return self._name

    @name.setter
    def name(self, value):
        self._name = value

在上面的代码中，我们创建了一个名为Person的QObject子类。在Person类中，我们使用pyqtProperty()声明了一个名为name的属性，并定义了与其关联的getter和setter方法。

接下来，我们可以通过以下方式使用Person类：

person = Person()
person.name = 'John'  # 设置name属性的值
print(person.name)  # 获取name属性的值

运行上面的代码，输出结果为：'John'。可以看到，我们通过person.name = 'John'来设置name属性的值，并使用person.name来获取name属性的值，就像操作普通的属性一样。

除了基本的getter和setter方法外，我们还可以定义reset方法和通知信号。以下是一个带有reset方法和通知信号的示例：

from PyQt5.QtCore import QObject, pyqtProperty, pyqtSignal

class Person(QObject):
    nameChanged = pyqtSignal()

    def __init__(self, name=''):
        super().__init__()
        self._name = name

    @pyqtProperty(str, notify=nameChanged)
    def name(self):
        return self._name

    @name.setter
    def name(self, value):
        self._name = value
        self.nameChanged.emit()
    
    @name.reset
    def resetName(self):
        self._name = ''

在上面的代码中，我们添加了一个名为nameChanged的pyqtSignal()信号，用于通知属性值的变化。我们还定义了一个resetName方法，当调用该方法时，属性值会被重置为空字符串。

以下是使用带有reset方法和通知信号的Person类的示例代码：

person = Person()
person.nameChanged.connect(lambda: print('Name changed'))
person.name = 'John'
print(person.name)
person.resetName()
print(person.name)

运行上面的代码，输出结果为：

Name changed
John
Name changed

可以看到，当调用person.name = 'John'时，会触发nameChanged信号，并打印出'Name changed'。调用person.resetName()后，再次调用person.name，输出为空字符串，并触发nameChanged信号。