Qt正确使用属性语法

Qt proper usage of properties syntax

本文关键字：属性语法 Qt      更新时间：2023-10-16

当我使用Q_PROPERTY定义属性时，我确保继承QObject并在类定义开始时声明Q_OBJECT宏。我这样声明这个属性:

Q_PROPERTY(QString MyProp READ getMyProp WRITE setMyProp)

，然后我这样使用:

myObject->MyProp = QString("test");

它告诉我没有MyProp这样的成员。有什么问题吗?

当然没有这样的成员，因为您自己已经说过getter称为getMyProp, setter称为setMyProp。成员MyProp的定义完全取决于您。下面，我将展示如何定义这样的成员。

我们还应该注意到，在Qt中，习惯上不会在getter前面加上get，而是简单地将其命名为属性之后。这样就有

Q_PROPERTY(int foo READ foo WRITE setFoo)
// rather than
Q_PROPERTY)int foo READ getFoo WRITE setFoo)

可能的解决方案包括:

(1)直接访问属性的数据成员——这会破坏属性系统授予的封装，因此不建议这样做。

class Direct : public QObject {
  Q_OBJECT
  Q_PROPERTY(int prop MEMBER prop)
public:
  int prop;
};
Direct d;
d.prop = 3;
Q_ASSERT(d.property("prop").toInt() == 3);

最后一行之所以有效，是因为moc生成了简单的getter和setter代码，这些代码随后可以通过元对象系统访问。该代码嵌入在元数据实现中，不会导致任何方法被添加到类本身。

(2)有一个返回引用的getter。当getter和setter都不重要时，这是最简单、开销低的方法。

class GetSet : public QObject {
  Q_OBJECT
  Q_PROPERTY(int prop READ prop WRITE setProp)
  int m_prop;
public:
  int & prop() { return m_prop; }
  int prop() const { return m_prop; }
  void setProp(int prop) { m_prop = prop; }
};
GetSet gs;
gs.prop() = 3; // assignment syntax through "getter"
Q_ASSERT(gs.property("prop").toInt() == 3);
gs.setProp(4); // setter syntax
Q_ASSERT(gs.property("prop").toInt() == 4);

(3)向属性公开充当代理的成员。这允许在没有调用语法的情况下使用代理:obj.prop而不是obj.prop()。

(3a)我们可以使用Qt属性系统访问一个命名的属性。QMetaProperty充当缓存，以避免在每次属性访问时重复查找名称。在每个属性访问上执行QVariant转换。

template <typename B, typename T> class PProxy {
  Q_DISABLE_COPY(PProxy)
  B * obj;
  QMetaProperty prop;
public:
  PProxy(B & o, const char * p) : obj(&o), 
    prop(o.metaObject()->property(o.metaObject()->indexOfProperty(p))) {}
  T operator=(const T & val) { prop.write(obj, val); return val; }
  T operator=(T && val) { prop.write(obj, val); return val; }
  operator T() const { return prop.read(obj).value<T>(); }
};
class ViaPProxy : public QObject {
  Q_OBJECT
  Q_PROPERTY(int prop READ getProp WRITE setProp)
  int m_prop;
public:
  PProxy<Direct, int> prop;
  ViaPProxy() : prop(*this, "prop") {}
  int getProp() const { return m_prop; }
  void setProp(int val) { m_prop = val; }
}
ViaPProxy vpp;
vpp.prop = 3; // invokes the setter through a proxy
Q_ASSERT(vpp.prop == 3);

(3b)代理可以直接使用getter和setter，而不是通过Qt属性系统和QVariant转换。这比(3a)的开销低，但要求存在getter和可选的setter。

template <typename B, typename T, 
          T (B::*get)() const, void (B::*set)(T) = 0> class DProxy {
  Q_DISABLE_COPY(DProxy)
  B & obj;
public:
  DProxy(B & o) : obj(o) {}
  T operator=(const T & val) { (obj.*set)(val); return val; }
  T operator=(T && val) { (obj.*set)(std::forward<T>(val)); return val; }
  operator T() const { return (obj.*get)(); }
};
class ViaDProxy : public QObject {
  Q_OBJECT
  Q_PROPERTY(int prop READ getProp WRITE setProp)
  int m_prop;
public:
  DProxy<Direct, int, &ViaDProxy::get, &ViaDProxy::set> prop;
  ViaDProxy() : prop(*this) {}
  int getProp() const { return m_prop; }
  void setProp(int val) { m_prop = val; }
}
ViaDProxy vdp;
vdp.prop = 3; // invokes the setter through a proxy
Q_ASSERT(vdp.prop == 3);
相关文章：