QT—动态属性系统

目录

一、创建动态属性

二、Q_PROPERTY宏参数类型 

三、演示

四、通过基类读写动态属性 

1.读属性

2.改属性 

---

一、创建动态属性

    在标准C++中，为了保证封装性，我们经常声明一个私有变量，然后声明两个公有函数，即set函数和get函数。在Qt中我们可以使用宏Q_PROPERTY()宏来实现这些。一个属性可以使用常规函数QObject::property()和QObject::setProperty()进行读写，不用知道属性所在类的任何细节，除了属性的名字。 

    Q_PROPERTY（）原型： 

 
// 中括号中的内容为可选项 
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]　　　　　　　　　　　  //不能被重写　　　　　　
)

二、Q_PROPERTY宏参数类型 

1. type name 

属性类型可以是QVariant支持的任何类型，也可以是用户定义的类型；

2. READ 和 MEMBER
如果没有MEMBER，则必须要有READ。
READ 后面定义获取属性值的函数，该函数是const；
WRITE 设置属性值，是可选的；
MEMBER 如果一个属性不需要 READ ，但又想使用属性系统，可以使用MEMBER来注册，MEMBER后面是成员变量的名字；

3. RESET

可选，将属性设置为默认值，该RESET函数必须返回void并且不带参数。

4. NOTIFY

可选，NOTIFY 后面跟该类中已经定义的一个信号函数，只要该属性的值发生更改，就会发出该信号。这个信号函数必须采用零个或一个参数，该参数必须与属性的类型相同。

5. REVISION int
可选，版本信息（通常用于QML）。

6. DESIGNABLE bool
可选，表示属性是否能在GUI设计工具的属性编辑器中可见（例如，Qt Designer）。大多数属性是DESIGNABLE（默认为true）。

7. SCRIPTABLE bool
可选，SCRIPTABLE属性表示脚本引擎是否应该可以访问此属性（默认为true）

8. STORED bool
可选，该属性是单独存在还是从其他值中获取的。大部分是true，一个反例是QWidget::minimumWidth()的值从QWidget::minimumSize()中获取，因此它的STORED为false。

9. USER bool
可选，表示是否可以被用户所编辑。

10. CONSTANT
可选，CONSTANT表明属性值是常量，不可更改，因此不能有WRITE方法或NOTIFY信号。对于给定的对象实例，常量属性的READ方法每次调用时都必须返回相同的值。对于对象的不同实例，该常数值可以是不同的。

11. FINAL
可选，FINAL表示属性不会被派生类覆盖，在某些情况下，这可用于性能优化。

三、演示

示例： 

1.新建桌面应用程序Widget，新建一个C++类MyPropertyClass，并声明Q_PROPERTY宏

#include 
 
class MyPropertyClass : public QObject
{
    Q_OBJECT
    //声明1_PROPERTY宏
    Q_PROPERTY(QString mask READ mask WRITE setMask NOTIFY maskChanged)
public:
    explicit MyPropertyClass(QObject *parent = nullptr);
    //只读
    QString mask() const;
    //只写
    void setMask(QString strMaskNum);
signals:
    void maskChanged(QString strMaskNum);
 
private:
    //用来保存mask的值
    QString m_mask;
};

读写函数的实现：

QString MyPropertyClass::mask() const
{
    return m_mask;
}
 
void MyPropertyClass::setMask(QString strMaskNum)
{
    m_mask=strMaskNum;
    emit maskChanged(strMaskNum);
}

4.在widget.h中声明一个槽方法

public slots:
    void maskChanged(QString str);  //槽方法与信号保持一致

槽方法实现 

void Widget::maskChanged(QString str)
{
    qDebug()<<"新的值为："<
}

在Widget.cpp文件中，在构造函数里将槽方法与MyPropertyClass类的动态属性的信号连接，并动态属性赋值

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    MyPropertyClass *myPc=new MyPropertyClass;
    connect(myPc,SIGNAL(maskChanged(QString)),this,SLOT(maskChanged(QString)));
    myPc->setMask("1000个");
}

执行结果：

四、通过基类读写动态属性 

1.读属性

 调用动态属性写函数将属性赋值为“1000个”，属性值被更改就会发送了maskChanged信号，我们又在Widget程序中将一个槽方法与该信号连接，在槽方法中输出修改的属性值。

也可以使用父类的property和setproperty方法获取修改属性值

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    MyPropertyClass* mypC=new MyPropertyClass;
    mypC->setMask("10000个口罩");//调用写方法
    
    //通过基类查看动态属性值
    QObject*obj=mypC;
    qDebug()<<"QObject读取的属性值"<property("mask").toString()
}

执行结果

2.改属性 

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    MyPropertyClass *myPc=new MyPropertyClass;
    connect(myPc,SIGNAL(maskChanged(QString)),this,SLOT(maskChanged(QString)));
    myPc->setMask("1000个");
    QObject *obj=myPc;
    //父类调用property读属性
    qDebug()<<"obj读属性："<property("mask").toString();
    //父类调用setProperty修改属性
    obj->setProperty("mask","2000个");
    qDebug()<<"obj读取修改后属性："<property("mask").toString();
}

 执行结果：

动态属性系统优点在于其继承自QObject，我们只需要一个QObject和子类的类名，便可以操作不同类的动态属性