QProperty Class

成员函数文档

[default] QProperty::QProperty()

创建一个包含 T 类型默认构造实例的属性。

[explicit] template <typename Functor> QProperty::QProperty(Functor &&f)

创建一个与给定的绑定表达式f 相关联的属性。该属性的值将设置为新绑定求值后的结果。每当绑定的依赖项发生变化时，该绑定都会被重新求值，属性的值也会相应地更新。

[explicit implicit] QProperty::QProperty(T &&initialValue)

Move-Constructs 根据提供的initialValue 构建一个属性。

[explicit] QProperty::QProperty(const QPropertyBinding<T> &binding)

创建一个与给定的binding 表达式绑定的属性。该属性的值将设置为新绑定求值后的结果。每当绑定的依赖项发生变化时，绑定都会被重新求值，属性的值也会相应地更新。

[explicit implicit] QProperty::QProperty(const T &initialValue)

根据提供的initialValue 构建一个属性。

[default] QProperty::~QProperty()

破坏该财产。

[since 6.2] template <typename Functor> QPropertyNotifier QProperty::addNotifier(Functor f)

将给定的函子f 注册为回调函数，每当属性值发生变化时都会调用该回调。

回调函数f 应为一种具有无参调用运算符() 的类型。这意味着您可以提供 C++ lambda 表达式、std::function，甚至是带有调用运算符的自定义结构体。

返回的属性变更处理程序对象会跟踪该订阅。当该对象超出作用域时，回调函数的订阅将被取消。

在某些情况下，该方法比 `onValueChanged()` 更易于使用，因为返回的对象不是模板。因此，它可以更方便地进行存储，例如作为类中的成员。

该函数在 Qt 6.2 中引入。

另请参见 onValueChanged() 和subscribe()。

QPropertyBinding<T> QProperty::binding() const

返回与该属性关联的绑定表达式。如果不存在此类关联，则返回一个通过默认构造函数构造的 QPropertyBinding<T>。

另请参阅 setBinding()。

template <typename Functor> QPropertyChangeHandler<Functor> QProperty::onValueChanged(Functor f)

将给定的函子f 注册为回调函数，每当属性值发生变化时，该回调函数就会被调用。每次值发生变化时，根据上下文的不同，处理程序要么立即被调用，要么被延迟调用。

回调函数f 应为一种具有无参数的普通调用运算符() 的类型。这意味着您可以提供 C++ lambda 表达式、std::function，甚至是带有调用运算符的自定义结构体。

返回的属性变更处理程序对象会记录该注册信息。当该对象超出作用域时，回调函数将被注销。

QPropertyBinding<T> QProperty::setBinding(const QPropertyBinding<T> &newBinding)

将该属性的值与提供的newBinding 表达式关联，并返回先前关联的绑定。该属性的值将设置为新绑定求值后的结果。每当绑定的依赖项发生变化时，绑定都会被重新求值，该属性的值也会相应地更新。

另请参阅 binding()。

[since 6.0] template <typename Functor> QPropertyBinding<T> QProperty::setBinding(Functor f)

将该属性的值与给定的函子f 关联，并返回先前关联的绑定。该属性的值将设置为新绑定求值的结果。每当绑定的依赖项发生变化时，绑定都会被重新求值，属性的值也会相应地更新。

该函数在 Qt 6.0 中引入。

另请参阅 《制定属性绑定》。

bool QProperty::setBinding(const QUntypedPropertyBinding &newBinding)

将该属性的值与提供的newBinding 表达式关联起来。该属性的值将设置为新绑定求值后的结果。每当绑定的依赖项发生变化时，绑定都会被重新求值，该属性的值也会相应地更新。

如果该属性的类型与绑定函数返回的类型相同，则返回 true；否则返回 false。

将newValue 赋值给此属性，并删除该属性关联的绑定（如有）。

[since 6.0] template <typename Functor> QPropertyChangeHandler<Functor> QProperty::subscribe(Functor f)

将给定的 functorf 注册为回调函数，该回调会在属性值发生变化时立即被调用，并在未来属性值发生变化时再次被调用。每次值发生变化时，根据上下文的不同，处理程序要么立即被调用，要么被延迟调用。

回调函数f 应为可复制的类型，并具有不带任何参数的普通调用运算符 operator()。这意味着您可以提供 C++ lambda 表达式、std::function，甚至带有调用运算符的自定义结构体。

返回的属性变化处理程序对象会跟踪该订阅。当该对象超出作用域时，回调将被取消订阅。

该函数于 Qt 6.0 中引入。

QPropertyBinding<T> QProperty::takeBinding()

将绑定表达式与该属性解除绑定，并返回该属性。调用此函数后，该属性的值仅会在为其赋值或设置新的绑定时发生变化。

QProperty<T>::parameter_type QProperty::value() const

返回该属性的值。在返回该值之前，可能会先求值一个与该属性绑定的绑定表达式。

另请参阅 setValue()。

将newValue 赋值给该属性，并返回对该QProperty 的引用。