QML與C++混合編程使用

請尊重原創作品和譯文。轉載請保持文章完整性，並以超連結形式註明原始作者地址http://blog.csdn.net/changsheng230，方便其他朋友提問和指正。

 

 

本文適合於對Qt/Quick有基本瞭解的讀者。首先回答一個比較常會被問到的問題：

 

什麼是QML，它與Quick的關係是什嗎？

Qt Quick是Qt User Interface Creation Kit的縮寫，而QML是Qt Quick最重要的組成部分，Qt Quick結合了如下技術：

1. 組件集合，其中大部分是關於圖形介面的
2. 基於JavaScript陳述性語言：QML （Qt Meta-Object Language的縮寫）
3. 用於管理組件並與組件互動的C++ API -  QtDeclarative模組

言歸正傳：通過Qt Creator，我們可以輕鬆產生一個Qt Quick的應用工程，從而為QML產生應用程式架構。具體操作詳見：建立qt quick (qml) 應用程式。

C++與QML的互動是通過註冊C++對象給QML環境得以實現的：

在C++實現中，非可視化的型別均為QObject的子類，可視化的類型均為QDeclarativeItem的子類。注意：QDeclarativeItem等同於QML的Item類。

如果使用者想要定義自己的型別，做法如下：

1. 在C++中，實現派生於QObject或QDeclarativeItem的子類，它是新定義item的實體物件；
2. 在C++中，將1中實現的新item類型註冊給QML；
3. 在QML中，匯入含有1中定義的新item的模組；
4. 在QML中，向使用標準的item一樣使用新定義的item

現舉例說明，我們現嘗試使用用Qt C++實現的MyButton對象（如下qml代碼），它有自己的屬性、方法以及訊號的handler。用法如下（它與使用其它標準的QML item一樣），所需要做的是 需要匯入包含MyButton的對應模組名稱及其版本“MyItems 1.0 ”。

//main.qml<br />import Qt 4.7<br />import MyItems 1.0<br />Item {<br /> width: 300; height: 200<br /> MyButton {<br /> //注意：x, y, width, height是繼承自item的屬性，無需再自訂的item中實現<br /> x: 50; y: 50<br /> width: 200; height: 100<br /> color: "gray" //自訂屬性<br /> onMySignals: dosth //自訂訊號mySignals<br />MouseArea {<br />anchors.fill: parent<br />onClicked: parent.myColor() // 調用C++定義的方法myColor<br />}<br /> }<br />} 

為了能夠上述qml代碼工作，需要為在Qt C++代碼中註冊MyButton及其所屬的模組，對應的main.cpp代碼如下：

#include <QtGui/QApplication><br />#include "qmlapplicationviewer.h"<br />int main(int argc, char *argv[])<br />{<br /> QApplication app(argc, argv);<br /> QmlApplicationViewer viewer;<br /> // MyButtonItem是與QML中MyButton相對應的C++實現的類名稱<br /> // 1，0是版本資訊；MyItems是MyButton所屬的模組名稱<br /> qmlRegisterType<MyButtonItem>("MyItems", 1, 0, "MyButton ");<br /> viewer.setOrientation(QmlApplicationViewer::Auto);<br /> viewer.setMainQmlFile(QLatin1String("qml/untitled/main.qml"));<br /> viewer.show();<br /> return app.exec();<br />} 

上面我們在QML中MyButton對象，有自己的屬性、方法以及訊號的handler，其實現均來自Qt C++。Qt C++需要作以下工作：

1. 首先要定義 QML中MyButton相對應的C++實現MyButtonItem，它必須繼承自QDeclarativeItem
2. 為了讓MyButton對象能夠使用其Color屬性，MyButtonItem類需要利用QT的PROPERTY系統，為Moc聲明其屬性
3. 為了讓MyButton對象能夠使用其myColor方法，MyButtonItem類需要聲明該方法，並標記為Q_INVOKABLE （另外一種解決方案是將myColor聲明為槽。
4. 為了讓MyButton對象能夠接受到C++所emit的訊號，並在onMySignals，MyButtonItem類需要聲明mySignals訊號

class MyButtonItem : public QDeclarativeItem<br />{<br /> Q_OBJECT<br /> Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)<br />signals:<br /> void colorChanged();<br /> void mySignals();<br />public:<br /> MyButtonItem(QDeclarativeItem *parent = 0);<br /> void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,<br /> QWidget *widget = 0);<br />public:<br /> const QColor &color() const;<br /> void setColor(const QColor &newColor);<br /> Q_INVOKABLE QColor myColor() const;<br />// Alternatives for myColor to be called from QML<br />//public slots<br /> //QColor myColor() const;<br />private:<br /> QColor m_color;<br />}; 

 

推薦相關好的文章作為本文的延伸： 在C++程式中使用QML