Q_PROPERTY参数化读写访问器

Q_PROPERTY with parameterized read and write accessors

本文关键字:读写 写访问 参数 PROPERTY      更新时间:2023-10-16

我有一个Configuration,其中包含有关文件位置的一些基本信息,如下载,安装,图片,音乐,文档等位置。这些目前使用 Q_PROPERTY 暴露给 QML。它们都有自己的访问器:

Q_PROPERTY(QUrl download_location READ download_location WRITE set_download_location NOTIFY download_location_changed)

这些访问器基本上做所有相同的事情,我想摆脱我必须编写的所有这些冗余代码。

我的第一个想法是有一个嵌套的类FileLocation,提供get,set和验证函数。但是,我将如何将它们连接到Q_PROPERTY

另外,如果我有一个像静态函数这样的东西,它接受参数,(例如 check_validity( QUrl location )(,我将如何从QML方面移交此参数?

我认为我在这里走错了路,所以我的问题是如何将Q_PROPERTY上下文中的冗余代码保持在合理的范围内,避免为非常相似的对象编写加载和加载的 get、set 和 change 函数?

下面是更多代码:

class Configuration : public QObject
{
  QObject
  Q_PROPERTY(QUrl download_location READ download_location WRITE set_download_location NOTIFY download_location_changed)
  Q_PROPERTY(QUrl music_location READ music_location WRITE set_music_location NOTIFY music_location_changed)
  ...
signals:
  void download_location_changed();
  void music_location_changed();
  ...
public slots:
  void set_download_location(QUrl location)
  {
    download_location = location;
    emit download_location_changed(download_location);
  }
  void set_music_location(QUrl location)
  {
    music_location = location;
    emit music_location_changed(music_location);
  }
  ...
private:
  QUrl download_location,
       music_location,
       ...;
}

所以正如你所看到的,有很多重复的代码做同样的事情,我想把它放低一点。我该怎么做?我正在考虑一些通用函数设置、获取、更改等,让成员处理是一个参数。但是后来我不知道如何从qml中移交要处理哪个成员。

我刚刚发现了通过 qmlRegisterType(...) 将C++类公开给 qml 的可能性 - 也许这就是这里的方式?

你可以去一个邪恶的宏:

#define IMPL(data, name) 
    inline decltype(data) name() const { return data; } 
    inline void set_##name(decltype(data) value) { if (value != data) { data = value; emit name##Changed();} }

当然,如果你不需要任何额外的东西,你可以简单地使用MEMBER属性,让Qt自动生成访问器。

但是,如果您需要在访问器中执行自定义操作,这将不起作用,宏将仅将您的内容添加到其中。

最后,当你声明一个Q_PROPERTY时,你可以右键单击该属性,转到重构,然后选择"生成缺少的成员...",Qt将为访问器生成默认存根,你只需要添加你的自定义内容。这样做的缺点是它有一个令人讨厌的习惯,即将生成的代码放在最愚蠢的地方,所以如果你想让你的类看起来整洁,你必须手动移动它。

qmlRegisterType()是当你想注册一个类型以便可以在 QML 中创建它时,你通常不需要做任何事情来访问 QML 的QObject派生对象 - 它适用于QObject衍生物,你只需要为没有生成元信息的类型注册元类型。

最后但并非最不重要的一点是 - 我认为将您的配置作为C++对象没有任何意义,您也可以在 QML 中执行此操作,并使用 Qt.labs.settings 使您的设置持久化。C++ 仅适用于性能关键部件。如果你在QML中进行配置,你不需要担心任何样板代码,因为它在QML中都是自动的,不需要编写访问器,不需要在每一个微小的更改上重新编译你的项目。