【Qt开发流程】之对象模型2：属性系统

描述

Qt提供了一个复杂的属性系统，类似于一些编译器供应商提供的属性系统。然而，作为一个独立于编译器和平台的库，Qt不依赖于非标准的编译器特性，如__property或[property]。
Qt解决方案适用于Qt支持的所有平台上的任何标准c++编译器。它基于元对象系统，该系统还通过信号和槽提供对象间通信。

声明属性要求

要声明属性，请在继承QObject的类中使用Q_PROPERTY()宏。
这个宏用于在继承QObject的类中声明属性。属性的行为类似于类数据成员，但它们具有可通过元对象系统访问的附加特性。

Q_PROPERTY(type name
           (READ getFunction [WRITE setFunction] |
            MEMBER memberName [(READ getFunction | WRITE setFunction)])
           [RESET resetFunction]
           [NOTIFY notifySignal]
           [REVISION int]
           [DESIGNABLE bool]
           [SCRIPTABLE bool]
           [STORED bool]
           [USER bool]
           [CONSTANT]
           [FINAL])

声明需要属性名称和类型以及READ函数。该类型可以是QVariant支持的任何类型，也可以是用户定义的类型。其他项是可选的，但WRITE函数是常见的。除USER外，其他属性默认为false。

例如:

Q_PROPERTY(QString title READ title WRITE setTitle USER true)

下面是取自类QWidget的属性声明的一些典型示例：

Q_PROPERTY(bool focus READ hasFocus)
Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
Q_PROPERTY(QCursor cursor READ cursor WRITE setCursor RESET unsetCursor)

下面是一个示例，展示了如何使用member关键字将成员变量导出为Qt属性。注意，必须指定NOTIFY信号才能允许QML属性绑定:

   Q_PROPERTY(QColor color MEMBER m_color NOTIFY colorChanged)
   Q_PROPERTY(qreal spacing MEMBER m_spacing NOTIFY spacingChanged)
   Q_PROPERTY(QString text MEMBER m_text NOTIFY textChanged)
   ...
signals:
   void colorChanged();
   void spacingChanged();
   void textChanged(const QString &newText);

private:
   QColor  m_color;
   qreal   m_spacing;
   QString m_text;

属性表现类似于类数据成员，但通过元对象系统可访问附加功能。

  • 如果未指定MEMBER变量，则需要一个READ访问器函数。它用于读取属性值。理论上，应该使用const函数来实现，并且必须返回属性的类型或该类型的const引用。例如，QWidget::focus是一个带有READ函数（QWidget::hasFocus()）的只读属性。
  • WRITE访问器函数是可选的。它用于设置属性值。它必须返回void，并且必须接受一个参数，要么是属性的类型，要么是指向该类型的指针或引用。例如，QWidget::enabled具有WRITE函数QWidget::setEnabled()。只读属性不需要WRITE函数。例如，QWidget::focus没有WRITE函数。
  • 如果未指定READ访问器函数，则需要一个MEMBER变量关联。这使得给定的成员变量可读可写，而无需创建READ和WRITE访问器函数。如果需要控制变量访问，仍然可以使用READ或WRITE访问器函数（但不能同时使用）。
  • RESET函数是可选的。它用于将属性设置回上下文特定的默认值。例如，QWidget::cursor具有典型的READ和WRITE函数（QWidget::cursor()和QWidget::setCursor()），它还有一个RESET函数QWidget::unsetCursor()，因为对QWidget::setCursor()的调用没有意义。RESET函数必须返回void并且不接受参数。
  • NOTIFY信号是可选的。如果定义了，它应指定该类中的一个现有信号，该信号在属性值更改时发出。MEMBER变量的NOTIFY信号必须接受零个或一个参数，该参数的类型必须与属性的类型相同。参数将采用属性的新值。只有在属性实际上发生更改时，才应该发出NOTIFY信号，以避免在QML中不必要地重新评估绑定，例如。当需要为未具有显式设置器的MEMBER属性自动发出该信号时，Qt会自动发出该信号。
  • REVISION编号是可选的。如果包含，则定义了属性及其通知器信号在API的特定修订版中使用（通常用于暴露给QML）。如果不包含，则默认为0。
  • DESIGNABLE属性指示属性是否应在GUI设计工具（例如Qt Designer）的属性编辑器中可见。大多数属性都是DESIGNABLE的（默认为true）。可以指定一个布尔成员函数代替true或false。
  • SCRIPTABLE属性指示该属性是否应由脚本引擎访问（默认为true）。您可以指定一个布尔成员函数代替true或false。
  • STORED属性指示该属性是否应被视为存在于自己或依赖于其他值上。它还指示在存储对象状态时是否必须保存属性值。大多数属性都是STORED的（默认为true），但是例如，QWidget::minimumWidth()的STORED为false，因为它的值只是从属性QWidget::minimumSize()的宽度组件中获取的，后者是一个QSize。
  • USER属性指示该属性是否指定为类的用户界面或可编辑属性。通常，每个类只有一个USER属性（默认为false）。例如，QAbstractButton::checked是（可检查）按钮的可编辑属性。请注意，QItemDelegate会获取和设置部件的USER属性。
  • CONSTANT属性的存在表示属性值是常量的。对于给定的对象实例，常量属性的READ方法在每次调用时必须返回相同的值。该常量值可以在对象的不同实例间有所不同。常量属性不能具有WRITE方法或NOTIFY信号。
  • FINAL属性的存在表示该属性不会被派生类覆盖。在某些情况下，这可以用于性能优化，但是不受moc的强制执行。永远不要覆盖FINAL属性。

可以继承READ、WRITE和RESET功能。它们也可以是虚拟的。当它们在使用多重继承的类中被继承时，它们必须来自第一个继承的类。

属性类型可以是QVariant支持的任何类型，也可以是用户定义的类型。在本例中，类QDate被认为是用户定义的类型。


Q_PROPERTY(QDate date READ getDate WRITE setDate)

因为QDate是用户定义的，所以必须包含 带有属性声明的头文件。

对于QMap、QList和QValueList属性，属性值是一个QVariant，其值是整个列表或映射。注意，Q_PROPERTY字符串不能包含逗号，因为逗号分隔了宏参数。因此，必须使用QMap作为属性类型，而不是QMap<QString,QVariant>。
为了保持一致性，也使用QList和QValueList而不是 QList和QValueList。

使用元对象系统对属性进行读写操作

可以使用泛型函数QObject::property()和QObject::setProperty()来读写属性，而不需要知道除了属性名称之外的任何关于所属类的信息。在下面的代码片段中，对QAbstractButton::setDown()的调用和对QObject::setProperty()的调用都设置属性“down”。

QPushButton *button = new QPushButton;
QObject *object = button;

button->setDown(true);
object->setProperty("down", true);

通过WRITE访问属性是两种方法中更好的一种，因为它更快，并且在编译时提供更好的诊断，但是以这种方式设置属性要求您在编译时了解该类。按名称访问属性使您可以访问在编译时不知道的类。您可以在运行时通过查询类的QObject、QMetaObject和QMetaProperties来发现类的属性。

QObject *object = ...
const QMetaObject *metaobject = object->metaObject();
int count = metaobject->propertyCount();
for (int i=0; i<count; ++i) {
    QMetaProperty metaproperty = metaobject->property(i);
    const char *name = metaproperty.name();
    QVariant value = object->property(name);
    ...
}

在上面的代码片段中，QMetaObject::property()用于获取在某个未知类中定义的每个属性的元数据。从元数据中获取属性名并传递给QObject::property()以获取当前对象中的属性值。

一个小示例

假设我们有一个类MyClass，它派生自QObject，并在其私有部分中使用Q_OBJECT宏。我们希望在MyClass中声明一个属性来跟踪优先级值。该属性的名称将是priority，其类型将是一个名为priority的枚举类型，该类型在MyClass中定义。

我们在类的私有部分使用Q_PROPERTY()宏声明属性。所需的READ函数名为priority，我们还包含了一个名为setPriority的WRITE函数。枚举类型必须使用Q_ENUM()宏在元对象系统中注册。注册枚举类型使枚举数名称可用于调用QObject::setProperty()。我们还必须为READ和WRITE函数提供自己的声明。MyClass的声明可能看起来像这样:

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(Priority priority READ priority WRITE setPriority NOTIFY priorityChanged)

public:
    MyClass(QObject *parent = 0);
    ~MyClass();

    enum Priority { High, Low, VeryHigh, VeryLow };
    Q_ENUM(Priority)

    void setPriority(Priority priority)
    {
        m_priority = priority;
        emit priorityChanged(priority);
    }
    Priority priority() const
    { return m_priority; }

signals:
    void priorityChanged(Priority);

private:
    Priority m_priority;
};

READ函数是const，并返回属性类型。WRITE函数返回void，并且只有一个属性类型的参数。元对象编译器执行这些要求。

给定一个指向MyClass实例的指针或一个指向MyClass实例的QObject指针，我们有两种方法来设置其优先级属性:

MyClass *myinstance = new MyClass;
QObject *object = myinstance;

myinstance->setPriority(MyClass::VeryHigh);
object->setProperty("priority", "VeryHigh");
qDebug().noquote() << "[" << __FILE__ << __LINE__ << "]" << myinstance->property("priority");

在这里插入图片描述
当把

object->setProperty("priority", "VeryHigh");

改为

object->setProperty("priority", "VeryHi");

再次输出，会输出为空，会自行检查，是安全的。
在这个例子中，作为属性类型的枚举类型在MyClass中声明，并使用Q_ENUM()宏在元对象系统中注册。这使得枚举值可以作为字符串使用，就像在调用setProperty()时一样。如果枚举类型在另一个类中声明，则需要它的完全限定名(即OtherClass::Priority)，并且其他类也必须继承QObject并使用Q_ENUM()宏在那里注册枚举类型。

还有一个类似的宏Q_FLAG()。像Q_ENUM()一样，它注册了一个枚举类型，但它将该类型标记为一组标志，即可以将值OR在一起。一个I/O类可能有枚举值Read和Write，然后QObject::setProperty()可以接受Read | Write。Q_FLAG()应该用来注册这个枚举类型。

动态属性

QObject::setProperty()也可用于在运行时为类的实例添加新属性。当使用名称和值调用它时，如果QObject中存在具有给定名称的属性，并且给定的值与属性的类型兼容，则该值将存储在属性中，并返回true。如果该值与属性的类型不兼容，则不会更改属性，并返回false。但是，如果具有给定名称的属性在QObject中不存在(即，如果它没有使用Q_PROPERTY()声明)，则一个具有给定名称和值的新属性将自动添加到QObject中，但仍然返回false。这意味着不能使用返回false来确定是否实际设置了特定属性，除非您事先知道该属性已经存在于QObject中。

注意，动态属性是在每个实例的基础上添加的，也就是说，它们被添加到QObject，而不是QMetaObject。通过将属性名称和无效的QVariant值传递给QObject::setProperty()，可以从实例中删除属性。QVariant的默认构造函数构造了一个无效的QVariant。

动态属性可以用QObject::property()查询，就像在编译时用Q_PROPERTY()声明的属性一样。

属性和自定义类型

属性使用的自定义类型需要使用Q_DECLARE_METATYPE()宏注册，以便它们的值可以存储在QVariant对象中。这使得它们既适合与类定义中使用Q_PROPERTY()宏声明的静态属性一起使用，也适合与运行时创建的动态属性一起使用。

向类添加附加信息

连接到属性系统的是一个额外的宏Q_CLASSINFO()，它可以用来将额外的名值对附加到类的元对象上，例如:

Q_CLASSINFO("Version", "3.0.0")

与其他元数据一样，类信息可以在运行时通过元对象访问;详情可以参考QMetaObject::classInfo()。

使用场景

  1. 自定义控件：通过属性系统，可以方便地添加自定义控件所需要的属性，并在运行时动态修改其属性值，以实现控件的个性化定制。

  2. 翻译：在多语言支持的应用程序中，可以将所有需要翻译的字符串作为属性添加到组件中，这样可以方便地将这些字符串全部翻译成不同的语言。

  3. 皮肤定制：通过属性系统，可以在运行时动态地修改控件的样式属性，以实现界面的不同皮肤定制。
    比如改变样式：

{
    // 创建QPushButton控件
    QPushButton *button = new QPushButton("Click me", this);

    // 添加样式属性
    button->setProperty("buttonColor", QColor(220, 220, 220));
    button->setProperty("buttonTextColor", QColor(50, 50, 50));

    // 设置初始样式
    setButtonStyle(button);

    // 在运行时修改样式属性
    button->setProperty("buttonColor", QColor(0, 255, 0));
    button->setProperty("buttonTextColor", QColor(255, 0, 0));
    setButtonStyle(button); // 重新设置样式
}

// 定义函数来根据样式属性设置样式表
void setButtonStyle(QPushButton* button) {
    QColor buttonColor = button->property("buttonColor").value<QColor>();
    QColor buttonTextColor = button->property("buttonTextColor").value<QColor>();
    button->setStyleSheet(QString("QPushButton { background-color: rgb(%1, %2, %3); color: rgb(%4, %5, %6); }")
                          .arg(buttonColor.red())
                          .arg(buttonColor.green())
                          .arg(buttonColor.blue())
                          .arg(buttonTextColor.red())
                          .arg(buttonTextColor.green())
                          .arg(buttonTextColor.blue()));
}

在这里插入图片描述

属性系统的优势

  1. 灵活性：通过属性系统，可以轻松地在运行时动态修改对象的属性值，从而实现动态控制组件的行为。

  2. 扩展性：开发人员可以轻松地为自定义的控件添加属性，并通过属性系统来进行控制，从而扩展控件的属性和功能。

  3. 易用性：Qt属性系统提供了简单易用的API，开发人员可以方便地使用属性系统来管理和操作对象的属性。

结论

年轻人嘛，现在没钱算什么，以后没钱的日子还多着呢。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mfbz.cn/a/220786.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

高性能网络编程 - 白话TCP 三次握手过程

高性能网络编程 - 白话TCP 三次握手过程

文章目录 概述TCP协议头的格式TCP Finite State Machine (FSM) 状态机三次握手如何在 Linux 系统中查看 TCP 状态 概述 每一个抽象层建立在低一层提供的服务上&#xff0c;并且为高一层提供服务。 我们需要知道 TCP在网络OSI的七层模型中的第四层——Transport层 -----------…
阅读更多...
百度智能云正式上线Python SDK版本并全面开源

百度智能云正式上线Python SDK版本并全面开源

文章目录 前言一、SDK的优势二、千帆SDK&#xff1a;快速落地LLM应用三、如何快速上手千帆SDK3.1、SDK快速启动3.2. SDK进阶指引 3.3. 通过Langchain接入千帆SDK4、开源社区 前言 百度智能云千帆大模型平台再次升级&#xff01;在原有API基础上&#xff0c;百度智能云正式上线…
阅读更多...
MicroPython标准库

MicroPython标准库

MicroPython标准库 arraybinascii(二进制/ASCII转换)builtins – 内置函数和异常cmath – 复数的数学函数collections – 集合和容器类型errno – 系统错误代码gc – 控制垃圾收集器hashlib – 散列算法heapq – 堆队列算法io – 输入/输出流json – JSON 编码和解码math – 数…
阅读更多...
周周爱学习之Redis重点总结

周周爱学习之Redis重点总结

redis重点总结 在正常的业务流程中&#xff0c;用户发送请求&#xff0c;然后到缓存中查询数据。如果缓存中不存在数据的话&#xff0c;就会去数据库查询数据。数据库中有的话&#xff0c;就会更新缓存然后返回数据&#xff0c;数据库中也没有的话就会给用户返回一个空。 1.缓…
阅读更多...
【6】PyQt信号和槽

【6】PyQt信号和槽

1. 信号和槽简介 信号和槽机制是 QT 的核心机制&#xff0c;应用于对象之间的通信 信号和槽是用来在对象间传递数据的方法当一个特定事件发生的时候&#xff0c;signal会被emit出来&#xff0c;slot调用是用来响应相应的signal的Qt中对象已经包含了许多预定义的 signal&#…
阅读更多...
全网最新最全的Appium自动化：使用appium后安卓手机无法调出键盘解决方法

全网最新最全的Appium自动化：使用appium后安卓手机无法调出键盘解决方法

问题&#xff1a;用appium进行真机调试后&#xff0c;使用手机的app进行输入时无法调出键盘。 原因&#xff1a;appium调试时&#xff0c;将手机输入法设置成了Unicode IME 注&#xff1a;按键详细操作参考&#xff1a;转载至 作者&#xff1a;oscarforever 地址&#xff1…
阅读更多...
Java链接数据库

Java链接数据库

本文介绍的是Java链接数据库中的JDBC操作&#xff0c;JDBC虽然现在用的不多&#xff0c;但面试的时候会问道。需要有相应的了解。下面以链接MySQL为例子。 JDBC 什么jdbc Java DataBase Connectivity是一种用于执行SQL语句的Java API&#xff0c;它由一组用Java语言编写的类和…
阅读更多...
制作一个RISC-V的操作系统五-RISC-V汇编语言编程一

制作一个RISC-V的操作系统五-RISC-V汇编语言编程一

文章目录 RISC-V汇编语言入门汇编语言概念简介 汇编语言语法介绍&#xff08;GNU版本&#xff09; RISC-V汇编语言入门 汇编语言概念简介 高级&#xff1a;可以理解就是更贴近人的理解 低级&#xff1a;可以理解就是更贴近机器的 难移植&#xff1a;汇编指令基本上和机器指令…
阅读更多...
对标Gen-2！Meta发布新模型，进军文生视频赛道

对标Gen-2！Meta发布新模型，进军文生视频赛道

随着扩散模型的飞速发展&#xff0c;诞生了Midjourney、DALLE 3、Stable Difusion等一大批出色的文生图模型。但在文生视频领域却进步缓慢&#xff0c;因为文生视频多数采用逐帧生成的方式,这类自回归方法运算效率低下、成本高。 即便使用先生成关键帧,再生成中间帧新方法。如…
阅读更多...
网络模拟与网络仿真

网络模拟与网络仿真

目录 一、概念界定 二、模拟&#xff08;simulation&#xff09;与仿真&#xff08;emulation&#xff09; 2.1 模拟&#xff08;simulation&#xff09; 2.2 仿真&#xff08;emulation&#xff09; 2.3 区分 三、网络模拟与网络仿真 3.1 网络模拟 3.2 网络仿真 3.…
阅读更多...
软件测试要学习的基础知识——黑盒测试

软件测试要学习的基础知识——黑盒测试

黑盒测试概述 黑盒测试也叫功能测试&#xff0c;通过测试来检测每个功能是否都能正常使用。在测试中&#xff0c;把程序看作是一个不能打开的黑盒子&#xff0c;在完全不考虑程序内部结构和内部特性的情况下&#xff0c;对程序接口进行测试&#xff0c;只检查程序功能是否按照…
阅读更多...
解析 Smilee Finance：基于无偿损失的链上期权方案

解析 Smilee Finance：基于无偿损失的链上期权方案

“有了 Smilee Finance&#xff0c;无偿损失或许不再是一种损失&#xff0c;它也更可能是一种可组合性的收益” 无偿损失 流动性挖矿是引燃 DeFi Summer 的导火索&#xff0c;在 AMM DEX 中&#xff0c;它允许用户将资产按照比例添加到 AMM 流动性池中成为 LP&#xff0c;以为交…
阅读更多...
POJ 3233 Matrix Power Series 动态规划（矩阵的幂）

POJ 3233 Matrix Power Series 动态规划（矩阵的幂）

一、题目大意 给出一个矩阵A&#xff0c; 输出矩阵B的每一项对M取余数的值。 二、解题思路 以二维矩阵为例&#xff0c;首先计算K2的情况&#xff0c;我们设结果矩阵为B 有如下表达式 那么不难看出&#xff0c;需要的矩阵其实就是以下的两个矩阵相乘后的左上角的N*N个 然后…
阅读更多...
RoPE旋转位置编码浅析

RoPE旋转位置编码浅析

RoPE旋转位置编码浅析 本文介绍了旋转位置编码RoPE在大模型中的广泛应用，包括Llama、Mistral 7B、Baichuan、ChatGLM、Qwen、…等。由于计算资源限制，大模型通常在较小的上下文长度中进行训练，导致在推理超出预训练长度时性能显著下降。为了解决这个问题，涌现了许多基于Ro…
阅读更多...
火山引擎DataTester升级MAB功能，助力企业营销决策

火山引擎DataTester升级MAB功能，助力企业营销决策

更多技术交流、求职机会&#xff0c;欢迎关注字节跳动数据平台微信公众号&#xff0c;回复【1】进入官方交流群 DataTester&#xff0c;火山引擎推出的 AB 测试与智能优化平台&#xff0c;近日宣布对其 MAB&#xff08;Multi-armed Bandit&#xff09;功能进行了升级&#xff0…
阅读更多...
如果不小心修改了按钮的名字并且忘记了原名字

如果不小心修改了按钮的名字并且忘记了原名字

出现上述情况&#xff0c;可以右边点击转到代码&#xff0c;注释掉问题行&#xff0c;此页的设计界面就恢复了。
阅读更多...
MySQL主从复制（一主一从、双主双从）

MySQL主从复制（一主一从、双主双从）

一、概述 1. 数据库主从概念、优点、用途 主从数据库是什么意思呢&#xff0c;主是主库的意思&#xff0c;从是从库的意思。数据库主库对外提供读写的操作&#xff0c;从库对外提供读的操作。 　　数据库为什么需要主从架构呢&#xff1f; 高可用&#xff0c;实时灾备&#x…
阅读更多...
股价暴涨192%后，夏威夷控股股票还值得买入吗？

股价暴涨192%后，夏威夷控股股票还值得买入吗？

来源&#xff1a;猛兽财经 作者&#xff1a;猛兽财经 这两家公司计划组建一个横跨太平洋的航空公司 阿拉斯加航空(ALK )近期宣布它已和夏威夷航空(HA)达成协议&#xff0c;将以19亿美元现金和承担债务的方式收购夏威夷控股的母公司。 但这一消息却使两家公司的股价走向了相反的…
阅读更多...
技术面试时，被问及职业规划，怎么回答才加分？

技术面试时，被问及职业规划，怎么回答才加分？

对于职场人士来说&#xff0c;但凡涉及到面试&#xff0c;90%以上的概率你会被问到职业规划。而作为一个技术人士&#xff0c;本身的表达能力就比硬实力薄弱一些。很多人一上来的回答就是&#xff1a;先做技术岗&#xff0c;阅历深点了做管理。这样的回答&#xff0c;往往前脚刚…
阅读更多...
融云 Global IM UIKit，灵活易用的即时通讯组件设计思路和最佳实践

融云 Global IM UIKit，灵活易用的即时通讯组件设计思路和最佳实践

&#xff08;全网都在找的《社交泛娱乐出海作战地图》&#xff0c;点击获取&#x1f446;&#xff09; 融云近期推出的 Global IM UIKit&#xff0c;支持开发者高效满足海外用户交互体验需求&#xff0c;且保留了相当的产品张力赋予开发者更多自由和灵活性&#xff0c;是实现全…
阅读更多...
最新文章

Copyright @ 2022~2023

友情链接： 我的编程经验分享 一条长河网 尧图网站开发 尧图建网站