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同时出现
9 FINAL 表明该属性不会被派生类中重写
**********************************************************************************************
class Test : public QObject
{
Q_OBJECT
Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
public:
Test(QObject *parent = 0) : QObject(parent) {}
virtual ~Test(){}
void setEnabled(bool e) { enabled = e; }
bool isEnabled() const { return enabled; }
private:
bool enabled;
};
然后在主函数中
Test *test = new Test;
test->setProperty("enabled", true);
//test->setEnabled(true); //ok also work
if(test->property("enabled").toBool())
***************************************************************************************************
内省 intropection 运行时查询对象信息
- //每个对象可以通过QObject::setObjectName()和QObject::objectName()设置、取得类的实例的名字
- FirstQtApp obj;
- obj.setObjectName("instanceName");
- QString name1 = obj.objectName(); // return instanceName
- //每个对象还可以通过它的元对象className方法得到类的名字
- QString name2 = obj.metaObject()->className(); // return FirtstQtApp
- //每个对象可以通过QObject::inherits方法来查询是否对前对象类派生于量一个类
- bool isherited = obj.inherits("QObject"); // returns true
- isherited = obj.inherits("QWideget"); // returns true
让我们再来一下QObject::inherits方法的底层实现:
inline bool inherits(const char *classname) const
{ return const_cast<QObject *>(this)->qt_metacast(classname) != 0; }
总结:
1. Qt是通过QObject、QMetaObject类实现其内省机制,
2. QObject暴露给用户的共有自省方法有objectName(), inherits(), isWidgetType()等
3. 大多数自省方法是QObject派发给QMetaObject实现 (e.g. QMetaObject::className,),元对象模型编译器moc负责自省方法的实现
4. 更多自省方法定义在QMetaObject,而是为了等信号槽通讯、事件派发等机制,