Q_PROPERTY 介绍 .

最新推荐文章于 2025-11-06 21:35:23 发布

转载最新推荐文章于 2025-11-06 21:35:23 发布 · 2.5w 阅读

文章标签：

#qt #编译器 #system #跨平台 #文档 #user

本文介绍了QT提供的属性系统，包括Q_PROPERTY宏的使用方法及其与元对象系统的关系。文章详细解释了如何通过宏声明属性，以及如何定义读取、写入、重置属性的方法和通知信号。

QT提供了一个成熟的属性系统，但是作为一个跨平台的且与编译器无关的库，qt不依赖于非标准的编译器功能例如 __property or [property]；

QT的强大之处在于它可以支持任何标准的c++编译器。 QT是基于 Meta-Object System（元对象）和signals and slots（信号槽）的.

Q_PROPERTY

Q_PROPERTY()是一个宏，用来在一个类中声明一个属性property，由于该宏是qt特有的，需要用moc进行编译，故必须继承于QObject类。

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

可能还不太好理解不过下面介绍几个特殊的例子你就豁然开朗了

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

一个属性行为类似于类里面的数据成员，但是他是却可以通过Meta-Object System来访问。

在外界看来，property跟类中数据成员没有什么区别，但是还是有几点不一样，参考qt文档，主要有以下几点：
1.必须有一个read函数。它用来读取属性值。因此用Const限定。它的返回值类型必须为属性类型或者属性类型的引用或者指针。不能是其他类型例如：QWidget::hasFocus().
2.有一个可选的write函数。它用来设置属性值，它的返回值必须为void型，而起必须要含有一个参数。例如:QWidget::setEnabled()
3.一个reset函数能够把property设置成其默认状态，它也是可选的。复位功能必须返回void，并且不带参数，

4.一个NOTIFY信号是可选的。如果定义，它提供了一个信号这个信号在值发生改变时会自动被触发。

5.如果定义了"STODE"属性表明这是一直存在的。QWidget::minimumSize()
6.一个"DESIGNABLE"属性表明该property能在GUI builder(一般为Qt Designer)可见

7.USER 属性表面是否可以被用户所编辑

8 CONST设定属性是不可修改的所以不能跟WRITE或者NOTIFY同时出现

9FINAL表明该属性不会被派生类中重写