Qt自学之路（八）-属性系统

Qt属性系统支持在类中定义属性并通过通用接口函数QObject::setProperty()及Object::Property()函数对对象属性进行设置及查询。自定义的属性还可以被qml程序识别，这也是通过C++编写qml组件时，定义组件属性的方式。

一、属性声明方式

属性声明方式如下图所示：

Q_PROPERTY(type name
           (READ getFunction [WRITE setFunction] |
            MEMBER memberName [(READ getFunction | WRITE setFunction)])
           [RESET resetFunction]
           [NOTIFY notifySignal]
           [REVISION int | REVISION(int[, int])]
           [DESIGNABLE bool]
           [SCRIPTABLE bool]
           [STORED bool]
           [USER bool]
           [BINDABLE bindableProperty]
           [CONSTANT]
           [FINAL]
           [REQUIRED])

其中参数非常多，但是我目前用到的其实就是type name Read Write Notify Requierd这几个参数

Read参数需要指定一个访问函数。通常就是一个返回目标类型的无参函数。如果没有指定MEMBER变量，那么Read 访问函数必须指定。

Write参数需要指定一个修改函数，通常就是一个无返回值的接受目标类型的单参函数。这个参数是可选的。如果没有指定Write参数，则属性是只读的。

Notify参数需要指定一个信号，在编写qml控件时，只有指定了notify参数，才能将其他属性与此属性进行绑定。这个参数是可选的。

指定了REQUIRED参数的属性，C++程序并不强制用户必须指定此属性的值。但是在qml程序中，一个类中的 所有Required属性必须全部指定才能生成对象。

type参数必须是一个QVariant类支持的类型或者是用户自定义类型。

以下是属性声明的示例：

Q_PROPERTY(bool isStop READ isStop WRITE setIsStop NOTIFY isStopChanged)
Q_PROPERTY(double progress READ progress WRITE setProgress NOTIFY progressChanged)
Q_PROPERTY(double volume READ volume WRITE setVolume NOTIFY volumeChanged)

二、采用Meta-Object系统对属性进行读写

可以通过调用QObject::property()函数 获取对象的属性。可以通过QObject::setProperty()函数设置对象属性。以下是代码示例：

QPushButton *button = new QPushButton;
QObject *object = button;
object->setProperty("down", true);

可以采用如下方式，获取一个对象所有属性值：

QObject *object = ...
const QMetaObject *metaobject = object->metaObject();
int count = metaobject->propertyCount();
for (int i=0; i<count; ++i) {
    QMetaProperty metaproperty = metaobject->property(i);
    const char *name = metaproperty.name();
    QVariant value = object->property(name);
    ...
}

三、动态属性

可以通过调用QObject::setProperty() 函数，在运行时为对象动态添加属性。如果一个对象没有指定的属性，则QObject::setProperty() 函数会为这个对象添加相应的属性。这个新增加的属性只是添加到这个对象上，并不是添加到类中。调用QObject::setProperty() 时如果传入无效值，可以将对应的属性从对象中删除。