Q_PROPERTY 语法

Q_PROPERTY 是 Qt 中的一个宏，用于将 C++ 类的成员变量（属性）暴露给 Qt 的元对象系统，以便在 Qt 的信号槽机制、属性系统等功能中使用。其语法如下：

Q_PROPERTY(type name READ getFunction [WRITE setFunction] [RESET resetFunction] [NOTIFY notifySignal] [DESIGNABLE bool] [SCRIPTABLE bool] [STORED bool] [USER bool] [CONSTANT] [FINAL])

其中，type 是属性的类型，name 是属性的名称（以字符串形式表示），getFunction 是用于读取属性值的成员函数，setFunction 是用于设置属性值的成员函数，resetFunction 是用于重置属性值的成员函数，notifySignal 是属性值发生变化时触发的信号，DESIGNABLE、SCRIPTABLE、STORED、USER 和 CONSTANT 等参数用于设置属性在 Qt Designer 中的可见性、在 Qt 脚本中的可用性、是否存储在 QSettings 中、是否是用户定义的属性和是否是只读属性等。

例如，以下代码演示了如何使用 Q_PROPERTY 定义一个名为 text 的字符串属性：

class MyWidget : public QWidget
{
    Q_OBJECT
    Q_PROPERTY(QString text READ text WRITE setText NOTIFY textChanged)
public:
    explicit MyWidget(QWidget *parent = nullptr);

    QString text() const;
    void setText(const QString &text);

signals:
    void textChanged(const QString &text);

private:
    QString m_text;
};

QString MyWidget::text() const
{
    return m_text;
}

void MyWidget::setText(const QString &text)
{
    if (m_text != text) {
        m_text = text;
        emit textChanged(m_text);
    }
}

在上面的代码中，我们使用 Q_PROPERTY 将 MyWidget 类的 m_text 成员变量暴露为一个名为 text 的属性，通过实现 text() 和 setText() 成员函数来读取和设置属性值，并通过 textChanged() 信号来通知属性值的变化。这样，我们就可以在 Qt 的信号槽机制、属性系统等功能中使用这个属性了。