__property

等关键字实现属性系统#xff0c;用于提供对成员变量的访问权限#xff0c;Qt

属性系统

元对象系统最主要的功能是实现信号和槽机制当然也有其他功能就是支持属性系统。

有些高级语言通过编译器的

__property

的类库时也会用到属性系统。

下面我们介绍简化版的属性系统只列举了属性系统里面几个基本的条目。

4.4.1

为了保持类的封装特性通常成员变量需要保持私有状态而为了与其他对象协作就需要提供相应的

get/set

函数。

如果成员变量的数值发生了变化通常也需要提供通知NOTIFY信息告知相关对象Qt

函数可以作为槽函数方便接收相关对象的信号以实现自动调整比如上一节标签控件的

setText

宏。

下面介绍简化版的属性声明第一类是不指明与属性相关的私有成员变量这时必须至少提供该属性的读函数

Q_PROPERTY(type

setFunction中括号表示可选写函数不是必须的。

RESET

resetFunction重置函数将属性设为某个默认值中括号表示可选重置函数不是必须的。

NOTIFY

name

仅仅是一个用于标识属性的名字它不是实际存在的成员变量属性系统不会自动生成成员变量它就是虚无的名字代号不同属性的名字不能相同。

对于属性用到的数值会存在一

私有成员变量、读函数、写函数、信号等需要另外编写这些声明对于函数还需要编写实体代码。

上面是不明确指出私有成员变量的情形也可以明确指出使用了哪个成员变量这时候属性声明为

Q_PROPERTY(type

在明确标出属性使用的成员变量的情况下属性的读写函数可以省略不写Qt

moc

工具会自动为成员变量生成读写代码而重置函数、信号等需要自己声明并编写必须的代码如果声明了属性值变化的通知信号那么

moc

通知信号是必须的一般建议把成员变量、读函数、写函数、通知信号都明确标出来这样方便程序员阅读和使用。

4.4.2

Q_PROPERTY()宏声明的其实都是声明好的普通属性在程序编译时就已经规定好了本小节示范普通属性的例子下一小节示范在运行时动态添加属性。

本

main

widget.h添加属性的声明代码、读写函数声明、信号声明和成员变量

#ifndef

0);~Widget();//声明属性//不直接标出成员变量的形式Q_PROPERTY(QString

nickName

nickNameChanged)//直接标出成员变量的形式Q_PROPERTY(int

count

countChanged)//标出成员变量可以省略读写函数Q_PROPERTY(double

value

valueChanged)//nickName读函数声明const

QString

count();//value属性声明时指出了成员变量并省略了读写函数它的读写代码由moc工具自动生成//value数值被修改时valueChanged信号会自动触发//自动生成的读写代码只有简单的读写功能不能做数值有效性检查signals://三个属性数值变化时发信号void

QString

slots://写函数通常可以作为槽函数方便与其他信号关联自动调整数值//nickName写函数声明void

setNickName(const

属性声明里的读写函数都需要程序员自己编写信号自己声明并在写函数里触发。

写函数

setNickName()

的声明放到槽函数声明部分了这样方便关联其他信号实现自动调整属性值。

虽然属性声明里没说有成员变量但是需要自己定义一个私有变量

m_nickName

工具自动生成。

因此这种极简形式的属性它只需要在头文件里放三行声明代码其他所有代码都不需要

Q_PROPERTY(double

除了属性声明本身的一句就只需要声明属性值变化是的信号和私有成员变量。

moc

节专门讲这些代码没有函数的自然没有相关的槽函数所以如果希望把写函数作为槽函数来用就得用类

count

ui_widget.hWidget::Widget(QWidget

*parent)

m_nickName){//数值没变化直接返回return;}//修改数值并触发信号m_nickName

strNewName;emit

m_count){//数值没变化直接返回return;}//修改数值并触发信号m_count

nNewCount;emit

setNickName()里面代码首先判断传入的参数值是否与旧的值相同如果是一样的就不用修改直接返回。

如果新旧数值不同那就设置成员变量为新的值并发送数

nickNameChanged并把新值作为参数放到信号里面。

set

函数里其实可以顺便做一下数值的有效性检查上面代码里省略了有效性

对于写函数

w;//属性读写//通过写函数、读函数w.setNickName(

Wid

);qDebug()w.nickName();w.setCount(100);qDebug()w.count();//通过

setProperty()

2.3456);qDebug()fixedw.property(value).toDouble();//显示窗体w.show();return

a.exec();

setNickName()、nickName()、setCount()、count()也可以使用属性通用的函数setProperty()

写属性property()

第一个参数是普通字符串就是属性的名称第二个参数是属性的数值QVariant

QVariant

代码先添加这些我们运行这个示例它执行的结果会打印到输出面板如下图所示

set***

函数里修改了属性值应该发了值改变的信号我们没有接收这些信号还不知道它们真发信号还是假发信号得验验货。

我们为这个例子添加一个

0);~ShowChanges();signals:public

slots://槽函数接收

QDebugShowChanges::ShowChanges(QObject

*parent)

这个仅仅是类的代码接收信号必须要定义一个对象然后才能关联源头信号和接收端槽函数下面修改

main.cpp

SLOT(RecvValue(double)));//属性读写//通过写函数、读函数w.setNickName(

Wid

);qDebug()w.nickName();w.setCount(100);qDebug()w.count();//通过

setProperty()

2.3456);qDebug()fixedw.property(value).toDouble();//显示窗体w.show();return

a.exec();

被自动调用并且会接收到新数值并打印出来。

运行这个修改后的示例得到的结果如下

qDebug()fixedw.property(value).toDouble();

setProperty()

信号没接收这个两个信号对应的槽函数和关联函数代码作为练习请读者自己动手完成。

下面小节示范动态属性的使用。

4.4.3

QObject::​dynamicPropertyNames()

const

false变量不可用qDebug()w.property(myValue).isValid();//添加属性

2.3456);//获取并打印qDebug()w.property(myValue).toDouble();//添加属性

Wid);//获取并打印qDebug()w.property(myName).toString();//获取所有动态属性名称打印名称列表qDebug()w.dynamicPropertyNames();w.show();return

a.exec();

通过在头文件声明普通的属性可以为属性标明相关的成员变量、读函数、写函数、变化通知信号等等而动态属性就没有这些特性它其实就是以成对的属性名、属性值的

setProperty()

属性系统不仅可以声明普通属性和在运行时添加动态属性还有一个衍生功能就是为类添加一些附加信息运行时可以查询这些附加信息方便程序员或用户查询相关信

4.4.4

函数获取过对象名称。

运行时还可以查询类的信息主要包括两种类信息一种是基本的类信息Qt

类会自动生成这些信息包括当前类名、继承树上的基类名称等另一类是程序员手动添加的类附加信息通过

Q_CLASSINFO()

0);~Widget();//类的附加信息Q_CLASSINFO(Version,

https://lug.ustc.edu.cn/sites/qtguide/)private:Ui::Widget

*ui;

头文件里添加了三行也就是三对“名称-值”都是普通字符串。

附加信息只需要添加到声明里不需要其他代码所以

widget.cpp

pMO-classInfoCount();//打印所有的附加信息for(int

i0;

pMO-classInfo(i);qDebug()info.name()\tinfo.value();}//基本信息qDebug()Class

Name:

w.objectName();//判断是否为基类qDebug()w.inherits(QWidget);qDebug()w.inherits(nothing);//显示窗口w.show();return

a.exec();

函数这个函数接收一个字符串如果是对象的直接或间接基类名称就返回

true否则返回

这个示例运行结果如下图所示这里窗体的类名和对象名正好是一样的其他情况可能不一样