[C++知识库]Qt Quick中QML和C++混合编程详解1——将C++类或对象导出到QML中（在qml中即可访问该类的实例的属性或者方法）

一、将类或对象导出到QML中-----可供QML访问的类（在qml中即可访问该类的实例的属性或者方法）

1、信号与槽
把C++对象的信号连接到QML定义的方法上，也可以把QML对象的信号连接到C++对象的槽上，也可以直接调用C++对象的信号或者槽

class ColorMaker : public QObject  
{  
    Q_OBJECT  
  
public:  
    ColorMaker(QObject *parent = 0);  
    ~ColorMaker();  
      
signals:  
    void colorChanged(const QColor & color);  
    void currentTime(const QString &strTime);  
  
public slots:  
    void start();  
    void stop();  
      
}; 

我们定义了 start() / stop() 两个槽， colorChanged() / currentTime() 两个信号，都可以在 QML 中使用

2、Q_INVOKABLE宏
在定义一个类的成员函数时使用 Q_INVOKABLE 宏来修饰，就可以让该方法被元对象系统调用。这个宏必须放在返回类型前面。

一旦你使用 Q_INVOKABLE 将某个方法注册到元对象系统中，在 QML 中就可以用 $Object.${method} 来访问，colorMaker 的 main.qml 中有使用 algorithm() 和 setAlgorithm() 的 QML 代码

class ColorMaker : public QObject  
{  
    Q_OBJECT  
  
public:  
    ColorMaker(QObject *parent = 0);  
    ~ColorMaker();  
      
    Q_INVOKABLE GenerateAlgorithm algorithm() const;  
    Q_INVOKABLE void setAlgorithm(GenerateAlgorithm algorithm);  
  
signals:  
    void colorChanged(const QColor & color);  
    void currentTime(const QString &strTime);  
  
public slots:  
    void start();  
    void stop();  
};

Component.onCompleted: {  
    colorMaker.color = Qt.rgba(0,180,120, 255);  
    colorMaker.setAlgorithm(ColorMaker.LinearIncrease);  
    changeAlgorithm(colorAlgorithm, colorMaker.algorithm());  
} 

3、Q_PROPERTY
Q_PROPERTY 宏用来定义可通过元对象系统访问的属性，通过它定义的属性，可以在 QML 中访问、修改，也可以在属性变化时发射特定的信号。要想使用 Q_PROPERTY 宏，你的类必须是 QObject 的后裔，必须在类首使用 Q_OBJECT 宏。

class QQuickText : public QQuickImplicitSizeItem  
{  
    Q_OBJECT  
    Q_ENUMS(HAlignment)  
  
  
    Q_PROPERTY(QString text READ text WRITE setText NOTIFY textChanged)  
    Q_PROPERTY(QFont font READ font WRITE setFont NOTIFY fontChanged)  
    Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)  
    ...  
      
public:  
    enum HAlignment { AlignLeft = Qt::AlignLeft,  
                       AlignRight = Qt::AlignRight,  
                       AlignHCenter = Qt::AlignHCenter,  
                       AlignJustify = Qt::AlignJustify };  
    ...  
    QString text() const;  
    void setText(const QString &);  
  
    QFont font() const;  
    void setFont(const QFont &font);  
  
    QColor color() const;  
    void setColor(const QColor &c);  
    ...  
};  

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 的所有选项，就往 QML 导出类这种场景来说，比较常用的是 READ / WRITE / NOTIFY 三个选项。我们来看看都是什么含义。
【1】READ 标记，如果你没有为属性指定 MEMBER 标记，则 READ 标记必不可少；声明一个读取属性的函数，该函数一般没有参数，返回定义的属性。
【2】WRITE 标记，可选配置。声明一个设定属性的函数。它指定的函数，只能有一个与属性类型匹配的参数，必须返回 void 。
【3】NOTIFY 标记，可选配置。给属性关联一个信号（该信号必须是已经在类中声

4、Q_ENUMS
如果你要导出的类定义了想在 QML 中使用枚举类型，可以使用 Q_ENUMS 宏将该枚举注册到元对象系统中。

一旦你使用 Q_ENUMS 宏注册了你的枚举类型，在 QML 中就可以用 $CLAS{S}_{N}AME.${ENUM_VALUE} 的形式来访问，比如 ColorMaker.LinearIncrease ，上节展示的 QML 代码片段已经使用了导出的枚举类型。

class ColorMaker : public QObject  
{  
    Q_OBJECT  
    Q_ENUMS(GenerateAlgorithm)  
  
public:  
    ColorMaker(QObject *parent = 0);  
    ~ColorMaker();  
      
    enum GenerateAlgorithm{  
        RandomRGB,  
        RandomRed,  
        RandomGreen,  
        RandomBlue,  
        LinearIncrease  
    };  
      
    Q_INVOKABLE GenerateAlgorithm algorithm() const;  
    Q_INVOKABLE void setAlgorithm(GenerateAlgorithm algorithm);  
  
signals:  
    void colorChanged(const QColor & color);  
    void currentTime(const QString &strTime);  
  
public slots:  
    void start();  
    void stop();  
};