This macro is used for declaring properties in classes that inherit QObject. Properties behave like class data members, but they have additional features accessible through the Meta-Object System.
这个宏用于在继承自 QObject的类中声明属性。属性就像类的数据成员一样,但它们通过元对象系统拥有额外的功能。
解释一下:
- QObject : 在Qt框架中,
QObject
是所有对象的基类。Qt的许多类,包括窗口、控件、事件等都是从QObject
继承的。 - Properties: 在Qt中,属性是对类数据成员的一种封装,提供了更强大和灵活的机制来操作这些数据成员。
- Meta-Object System: Qt的元对象系统提供了一种方式来查询和操作对象的类型信息、信号和槽以及其他特性。
cpp
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
是 Qt 框架中用于声明属性的一种宏。这个宏允许你在类中定义一个属性,并为其提供一些附加的元数据,如访问器、修改器、重置函数、通知信号等。下面是Q_PROPERTY
宏中各参数的详细解释:
- type: 属性的数据类型。
- name: 属性的名称。
- (READ getFunction [WRITE setFunction] | MEMBER memberName [(READ getFunction | WRITE setFunction)]): 指定如何访问和修改属性。你可以提供一个获取器(getFunction)和一个设置器(setFunction),或者直接使用类的成员变量(MEMBER)。
- RESET resetFunction: 提供了一个重置函数,该函数将属性的值重置为其默认值。
- NOTIFY notifySignal: 当属性的值改变时,发出一个通知信号。
- REVISION int: 属性的版本号,用于版本控制。
- DESIGNABLE bool: 是否可以在 Qt Designer 中编辑这个属性。
- SCRIPTABLE bool: 是否可以在 QML 中脚本访问这个属性。
- STORED bool: 是否存储属性值,即使在对象被销毁后也能保留。
- USER bool : 用户是否可以更改这个属性。默认是
true
。- CONSTANT: 指示属性是常量,即其值不能被修改。
- FINAL: 表示这个属性是最终的,不能被子类覆盖。
使用
Q_PROPERTY
可以方便地声明和管理 Qt 对象中的属性,并提供了一些额外的功能和灵活性。
public slots:
在Qt框架中,
public slots:
是一个特殊的访问修饰符,用于声明类的槽函数(slot functions)。槽函数是用于处理信号的函数,当一个信号被触发时,与之相关联的槽函数会被自动调用。例如,你可以在类定义中这样声明一个槽函数:
|---|-------------------------------------|
| |class MyClass : public QObject {
|
| |Q_OBJECT
|
| | |
| |public:
|
| |MyClass();
|
| | |
| |public slots:
|
| |void mySlotFunction();
|
| |};
|在这个例子中,
mySlotFunction
是一个槽函数,它可以被设计为响应某个信号的触发。要使槽函数能够响应信号,你需要在类的头文件中使用Q_OBJECT
宏,并在类定义中声明槽函数。然后,你可以使用QObject::connect
函数将信号与槽连接起来。例如:
|---|-------------------------------------------------------------------------------|
| |MyClass obj;
|
| |QObject::connect(&button, SIGNAL(clicked()), &obj, SLOT(mySlotFunction()));
|在这个例子中,当
button
被点击时,mySlotFunction
函数会被自动调用。