传说中的Q_PROPERTY怎么使用
原创
©著作权归作者所有:来自51CTO博客作者303103757q的原创作品,请联系作者获取转载授权,否则将追究法律责任
Q_PROPERTY在QT中应用是非常广泛的,而且比较好用。
这里看一下Q_PROPERTY的构成:
Q_PROPERTY(type name
02. READ getFunction //属性名
03. [WRITE setFunction] //读函数
04. [RESET resetFunction]
05. [NOTIFY notifySignal]
06. [DESIGNABLE bool]
07. [SCRIPTABLE bool]
08. [STORED bool]
09. [USER bool]
10. [CONSTANT]
11. [FINAL])
一个属性行为类似于类里面的数据成员,但是他是却可以通过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 TimeSleepConifg : public QObject//这里一定要注意,要使用 Q_PROPERTY必须继承QObject,否则无法使用
{
Q_OBJECT//这个宏定义也是必须的
Q_PROPERTY(int m_time_cont READ timeCnt WRITE setTimeCnt NOTIFY timeCntChanged)//
public:
void setTimeCnt(int e)//写函数
{
m_time_cont = e;
emit timeCntChanged();//这里触发信号,主要前面要加emit
}
int timeCnt() const//读函数
{
return m_time_cont;
}
void jsonFileWrite_T(QString Icont);//这个是我写的从一个json文件里去解析
QString jsonFileRead_T();//这是json文件的解析并且将得到的值返回
TimeSleepConifg();//这是构造函数,在构造函数里面;setTimeCnt(jsonFileRead_T().toDouble());
//调用jsonFileRead_T返回的值赋值给m_time_cont这是给它赋值的过程
Q_SIGNAL void timeCntChanged();//这是信号,在setTimeCnt()函数中被调用,意思就是一旦值发生更改将触发这个信号,
//只要引用了m_time_cont的地方都发生更改
private:
int m_time_cont;//这是定义的一个属性变量在qml中我们要引用的,这里可以看到它是个Q_PROPERTY中 是一样的
};
那么,接下来我们看一下qml中是怎么用到的
Text{
id:text1
x:50
y:80
width: 63
height: 26
text:idRootPriv.m_vm.time_obj.m_time_cont;//这里就绑定了m_time_cont,只要它发生更改就会自动更改
//这里的time_obj是上面那个类实例后的指针,前面的是我管理的类你们可以不看。
verticalAlignment: Text.AlignTop
horizontalAlignment: Text.AlignLeft
}