在實際QML應(yīng)用開發(fā)中,我們可以在JavaScript中動態(tài)的創(chuàng)建QML對象。這樣做可以延遲對象的實例化,當(dāng)我們在需要創(chuàng)建對象的時候才在JavaScript代碼中創(chuàng)建,則可以縮短應(yīng)用程序的啟動時間,還可以動態(tài)創(chuàng)建可視對象,有助于提高應(yīng)用程序性能。
創(chuàng)建動態(tài)對象
有兩種方法可以在JavaScript代碼中動態(tài)的創(chuàng)建對象。
第一種是:調(diào)用Qt.createComponent()來動態(tài)創(chuàng)建一個Component對象;
第二種是:使用Qt.createQmlObject()函數(shù),以QML字符串的方式創(chuàng)建一個對象。
如果我們已經(jīng)在QML文檔中定義了一個現(xiàn)有組件,并希望可以動態(tài)地創(chuàng)建該組件實例,那么可選擇第一種方法。當(dāng)我們需要在運行時創(chuàng)建QML對象,應(yīng)選擇第二種方法。
下文將分別介紹這兩種方法。
動態(tài)創(chuàng)建組件
要動態(tài)加載定義在QML文件中的組件,需調(diào)用Qt對象中的Qt.createcomponent()函數(shù)。這個函數(shù)將接收QML文件的URL參數(shù),并根據(jù)這個URL創(chuàng)建一個Component對象。
一旦創(chuàng)建了組件,則可以調(diào)用createObject()方法來創(chuàng)建該組件的一個實例。createObject()函數(shù)可以接收兩個參數(shù):
(1)參數(shù)一:第一個是新對象的父對象。父對象可以是圖形對象(即Item類型)或非圖形對象(即QtObject或C++ QObject類型)。只有帶有圖形父對象的圖形對象才會呈現(xiàn)到Qt Quick視覺畫布中。如果想在后續(xù)設(shè)置父函數(shù),我們可以將null傳遞給這個函數(shù)。
(2)參數(shù)二:第二個是可選參數(shù),是<屬性-值>的映射,用于定義對象的初始屬性值。在創(chuàng)建對象之前,將此參數(shù)指定的屬性值應(yīng)用于對象,可以避免綁定錯誤。當(dāng)然與在創(chuàng)建對象后定義屬性值和屬性綁定相比,這種方式在性能上有一些小的影響。
例如,這里有一個qml文件,名為MyComponent.qml,代表一個QML組件:
importQtQuick2.0 Rectangle{width:80;height:50;color:"red"}
然后創(chuàng)建一個JavaScript腳本文件:componentCreation.js。用于檢測在調(diào)用createObject()之前組件是否被創(chuàng)建好(如果QML文件是通過網(wǎng)絡(luò)加載的,則不可能立即就準(zhǔn)備好,故此處需要判斷處理),如下代碼:
varcomponent; varsprite; functioncreateSpriteObjects(){ component=Qt.createComponent("MyComponent.qml"); if(component.status==Component.Ready) finishCreation(); else component.statusChanged.connect(finishCreation); } functionfinishCreation(){ if(component.status==Component.Ready){ sprite=component.createObject(appWindow,{x:100,y:100}); if(sprite==null){ //ErrorHandling console.log("Errorcreatingobject"); } }elseif(component.status==Component.Error){ //ErrorHandling console.log("Errorloadingcomponent:",component.errorString()); } }
在實際的開發(fā)中,基本上都是從本地加載qml文件,這時候則可以省略finishCreation()函數(shù),立即調(diào)用createObject(),例如下例代碼:
functioncreateSpriteObjects(){ component=Qt.createComponent("Sprite.qml"); sprite=component.createObject(appWindow,{x:100,y:100}); if(sprite==null){ //ErrorHandling console.log("Errorcreatingobject"); } }
注意,上面例子中,createObject()都是在appWindow作為父參數(shù)傳遞的情況下調(diào)用的,因為動態(tài)創(chuàng)建的對象是一個可視化對象。創(chuàng)建的對象將成為main.qml中的appWindow對象的子對象,并出現(xiàn)在界面中。
接著我們在main.qml文件中使用import "componentCreation.js" as MyScript語句導(dǎo)入componentcreate.js文件,用于創(chuàng)建MyComponent對象:
importQtQuick2.0 import"componentCreation.js"asMyScript Rectangle{ id:appWindow width:300;height:300 Component.onCompleted:MyScript.createSpriteObjects(); }
如果需要將信號連接到動態(tài)創(chuàng)建對象的信號處理函數(shù),需使用信號的connect()方法。
以QML字符串形式創(chuàng)建對象
在QML開發(fā)中,很多時候都會在運行時定義QML對象,這時候則可以使用Qt.createQmlObject()函數(shù)來實現(xiàn),在函數(shù)中指定QML字符串來創(chuàng)建一個QML對象,如下代碼:
varnewObject=Qt.createQmlObject('importQtQuick2.0;Rectangle{color:"red";width:20;height:20}',parentItem,"dynamicSnippet1");
Qt.createQmlObject()函數(shù)需要三個參數(shù):
(1)第一個參數(shù)是要創(chuàng)建的QML字符串。其中的QML字符串就像在新qml文件中創(chuàng)建組件的編寫方式一樣。
(2)第二個參數(shù)是新對象的父對象。
(3)第三個參數(shù)是與新對象相關(guān)聯(lián)的文件路徑,用于報告錯誤信息。
【特別注意(一)】
如果QML字符串使用相對路徑方式導(dǎo)入文件,則該路徑應(yīng)該相對于父對象(方法的第二個參數(shù))所在的文件。
【特別注意(二)】
在構(gòu)建靜態(tài)QML應(yīng)用程序時,QML引擎會掃描QML文件來檢測導(dǎo)入依賴項。這樣,所有必需的插件和資源都在編譯時解析。但是,只考慮顯式的import語句(在QML文件頂部找到的那些),而不會考慮包含在字符串文本中的import語句。因此,為了支持靜態(tài)構(gòu)建,我們需要在使用Qt.createQmlObject()的QML文件中,還需要在文件頂部顯式地包含所有的導(dǎo)入信息。
管理動態(tài)創(chuàng)建的對象
在管理動態(tài)創(chuàng)建的對象時,必須確保創(chuàng)建上下文的生命周期比創(chuàng)建的對象長。否則,如果創(chuàng)建上下文先被銷毀,動態(tài)對象中的綁定和信號處理程序?qū)傲T工”。
實際的創(chuàng)建上下文取決于對象是如何創(chuàng)建的:
(1)如果使用了Qt.createComponent(),創(chuàng)建上下文就是在其中調(diào)用此方法的QQmlContext。
(2)如果調(diào)用Qt.createQmlObject(),創(chuàng)建上下文是傳遞給該方法的父對象的上下文。
(3)如果定義了一個Component{}對象,并且在該對象上調(diào)用了createObject()或incubateObject(),那么創(chuàng)建上下文就是組件定義的上下文。
備注:雖然動態(tài)創(chuàng)建的對象可以像其他對象一樣使用,但它們在QML中是沒有id屬性的。
刪除動態(tài)對象
在大多數(shù)用戶界面開發(fā)中,將可視對象的不透明度設(shè)置為0或?qū)⒖梢晫ο笠瞥銎聊唬瑒t可以滿足許多的開發(fā)需求了。但是,如果應(yīng)用界面中有多個動態(tài)創(chuàng)建的對象,那么刪除不使用的對象可能會獲得較好性能。
但注意不要手動刪除由QML對象工廠(如Loader和Repeater)動態(tài)創(chuàng)建的對象。另外還應(yīng)該避免刪除不是自己動態(tài)創(chuàng)建的對象。
我們可以使用destroy()方法刪除Item。該方法有一個可選參數(shù)(默認(rèn)為0),用于指定對象被銷毀前的延遲時間。
這里有一個例子:我們在application.qml文件中創(chuàng)建了SelfDestroyingRect的五個實例組件。每個實例運行一個NumberAnimation,當(dāng)animation完成時,調(diào)用它的根對象的destroy()來銷毀,代碼如下:
//application.qml
importQtQuick2.0 Item{ id:container width:500;height:100 Component.onCompleted:{ varcomponent=Qt.createComponent("SelfDestroyingRect.qml"); for(vari=0;i<5;?i++)?{ ????????????var?object?=?component.createObject(container); ????????????object.x?=?(object.width?+?10)?*?i; ????????} ????} }
//SelfDestroyingRect.qml
importQtQuick2.0 Rectangle{ id:rect width:80;height:80 color:"red" NumberAnimationonopacity{ to:0 duration:1000 onRunningChanged:{ if(!running){ console.log("Destroying...") rect.destroy(); } } } }
另外,application.qml可以調(diào)用object.destroy()來銷毀已創(chuàng)建的對象。
備注:上述代碼中,調(diào)用對象的destroy()是安全的。因為對象不會在調(diào)用destroy()的瞬間被銷毀,而是在腳本塊結(jié)束后的某個時刻被清除(非零延遲除外)。
在銷毀對象時,需要注意對象只有在動態(tài)創(chuàng)建的情況下才能動態(tài)銷毀。
對于使用Qt.createQmlObject()創(chuàng)建的對象也可以使用destroy()銷毀,例如下例JavaScript代碼:
varnewObject=Qt.createQmlObject('importQtQuick2.0;Rectangle{color:"red";width:20;height:20}', parentItem, "dynamicSnippet1"); newObject.destroy(1000);
審核編輯:劉清
-
URL
+關(guān)注
關(guān)注
0文章
139瀏覽量
15482 -
JAVA語言
+關(guān)注
關(guān)注
0文章
138瀏覽量
20182 -
javascript
+關(guān)注
關(guān)注
0文章
525瀏覽量
53946
原文標(biāo)題:“神級”般的QML開發(fā)技巧,學(xué)會了
文章出處:【微信號:嵌入式小生,微信公眾號:嵌入式小生】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。
發(fā)布評論請先 登錄
相關(guān)推薦
評論