JavaScript中创建动态 QML 对象的方法

更新时间：2021年12月14日 17:24:51 作者：友善啊，朋友

这篇文章主要介绍了 JavaScript中创建动态 QML 对象，下面文章主要分析了两中方法，分别是从 QML 字符串创建对象和动态创建组件以及删除对象等方法，具有有一定的参考价值，需要的小伙伴可以参考一下

一、动态创建对象

有两种方法可以从 JavaScript 动态创建对象：

调用 Qt.createComponent() 动态创建 Component 对象
使用 Qt.createQmlObject() 从 QML 字符串创建对象

虽然动态创建的对象可以与其他对象一样使用，但它们在 QML 中没有 id。

1.1、动态创建组件

可以调用它的 createObject() 方法来创建该组件的一个实例。这个函数可以接受两个参数：

第一个是新对象的父对象。父对象可以是图形对象（即 Item 类型）或非图形对象（即 QtObject 或 C++ QObject 类型）。只有带有图形父对象的图形对象才会被渲染到 Qt Quick 可视画布上。如果希望稍后设置父级，可以安全地将 null 传递给此函数。
第二个是可选的，是一个属性值对的映射，它定义了对象的初始任何属性值。此参数指定的属性值在对象创建完成之前应用于对象，避免在必须初始化特定属性以启用其他属性绑定时可能发生的绑定错误。此外，与在创建对象后定义属性值和绑定相比，性能优势很小。
示例。

Sprite.qml 它定义了一个简单的 QML 组件：

import QtQuick 2.0
 
Rectangle { width: 80; height: 50; color: "red" }

main.qml 导入了一个 componentCreation.js JavaScript 文件，该文件将创建 Sprite 对象：

import QtQuick 2.0
import "componentCreation.js" as MyScript
 
Rectangle 
{
    id: appWindow
    width: 300; height: 300
 
    Component.onCompleted: MyScript.createSpriteObjects();
}

componentCreation.js

var component;
var sprite;
 
function createSpriteObjects() 
{
    component = Qt.createComponent("Sprite.qml");
    if (component.status == Component.Ready)
        finishCreation();
    else
        component.statusChanged.connect(finishCreation);
}
 
function finishCreation() 
{
    if (component.status == Component.Ready) 
    {
        sprite = component.createObject(appWindow, {x: 100, y: 100});
        if (sprite == null) 
        {
            console.log("Error creating object");
        }
    } 
    else if (component.status == Component.Error) 
    {
        console.log("Error loading component:", component.errorString());
    }
}

当使用带有相对路径的文件时，路径应该是相对于执行 Qt.createComponent() 的文件。

也可以通过 incubateObject() 函数在不阻塞的情况下实例化组件。

1.2、从 QML 字符串创建对象

可以使用 Qt.createQmlObject() 函数从 QML 字符串创建 QML 对象，如下例所示：

const newObject = Qt.createQmlObject(`
    import QtQuick 2.0
    Rectangle 
    {
        color: "red"
        width: 20
        height: 20
    }
    `,
    parentItem,
    "myDynamicSnippet"
);

第一个参数是要创建的 QML 字符串。
第二个参数是新对象的父对象，适用于组件的父参数语义同样适用于 createQmlObject() 。
第三个参数是与新对象关联的文件路径，这用于错误报告。

如果 QML 字符串使用相对路径导入文件，则路径应该相对于定义父对象（方法的第二个参数）的文件。

在构建静态 QML 应用程序时，会扫描 QML 文件以检测导入依赖项。这样，所有必要的插件和资源都会在编译时解决。但是，这仅考虑显式导入语句（位于 QML 文件顶部的语句），而不考虑包含在字符串文字中的导入语句。为了支持静态构建，用户需要确保使用 Qt.createQmlObject() 的 QML 文件在文件顶部明确包含所有（包括字符串文字内部）必要的导入。

二、动态删除对象

在许多用户界面中，将可视对象的不透明度设置为 0 或将可视对象移出屏幕而不是将其删除就足够了。但是，如果有大量动态创建的对象，则删除未使用的对象可能会获得有价值的性能优势。

请注意：永远不应该手动删除由便利 QML 对象工厂（例如 Loader 和 Repeater）动态创建的对象。此外，应该避免删除不是自己动态创建的对象。

可以使用 destroy() 方法删除项目。此方法有一个可选参数（默认为 0），用于指定销毁对象之前的近似延迟（以毫秒为单位）。

示例。application.qml 创建 SelfDestroyingRect.qml 组件的五个实例。每个实例运行一个 NumberAnimation，当动画完成时，调用它的根对象上的 destroy() 来销毁自己：

application.qml

import QtQuick 2.0
 
Item 
{
    id: container
    width: 500; height: 100
 
    Component.onCompleted: 
    {
        var component = Qt.createComponent("SelfDestroyingRect.qml");
        for (var i=0; i<5; i++) 
        {
            var object = component.createObject(container);
            object.x = (object.width + 10) * i;
        }
    }
}

SelfDestroyingRect.qml

import QtQuick 2.0
 
Rectangle 
{
    id: rect
    width: 80; height: 80
    color: "red"
 
    NumberAnimation on opacity 
    {
        to: 0
        duration: 1000
 
        onRunningChanged: 
        {
            if (!running) 
            {
                console.log("Destroying...")
                rect.destroy();
            }
        }
    }
}

或者，application.qml 可以通过调用 object.destroy() 销毁创建的对象。

请注意：对该对象内的对象调用 destroy() 是安全的。对象不会在调用 destroy() 的瞬间被销毁，而是在该脚本块结束和下一帧之间的某个时间被清除（除非指定了非零延迟）。

另请注意，如果 SelfDestroyingRect 实例是像这样静态创建的：

Item 
{
    SelfDestroyingRect 
    {
        // ...
    }
}

这会导致错误，因为对象只有在动态创建时才能动态销毁。

使用 Qt.createQmlObject() 创建的对象可以类似地使用 destroy() 销毁：

const newObject = Qt.createQmlObject(`
    import QtQuick 2.0
    Rectangle 
    {
        color: "red"
        width: 20
        height: 20
    }
    `,
    parentItem,
    "myDynamicSnippet"
);
newObject.destroy(1000);

到此这篇关于 JavaScript中创建动态 QML 对象的方法的文章就介绍到这了,更多相关 JavaScript 创建动态 QML 对象内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

你不知道的 TypeScript 高级类型(小结)
这篇文章主要介绍了你不知道的 TypeScript 高级类型(小结)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-08-08
js事件绑定快捷键以ctrl+k为例
js为快捷键绑定事件，当按这个快捷键时就会触发事先绑定处理函数，下面以ctrl+k为例与大家分享下具体的实现代码
2014-09-09
可以读取EXCEL文件的js代码
js读取 EXCEL 文件的实现代码，比较全了大家可以自行测试了。
2009-08-08
怎样用Javascript实现单例模式
这篇文章主要介绍了怎样用Javascript实现单例模式，想学习设计模式的同学，可以参考下
2021-04-04
JS实战篇之收缩菜单表单布局
这篇文章主要介绍了JS实战篇之收缩菜单表单布局的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-12-12
javacript replace 正则取字符串中的值并替换【推荐】
replace() 方法用于在字符串中用一些字符替换另一些字符，或替换一个与正则表达式匹配的子串。这篇文章主要介绍了javacript replace 正则取字符串中的值并替换,需要的朋友可以参考下
2018-09-09
JS Map 和 List 的简单实现代码
本篇文章是对在JS中Map和List的简单实现代码进行了详细的分析介绍，需要的朋友参考下
2013-07-07
原生JS获取URL链接参数的几种常见方法
这篇文章主要给大家介绍了关于利用原生JS获取URL链接参数的几种常见方法,文中通过实例代码以及图文介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2022-03-03
js完美解决IE6不支持position:fixed的bug
关于IE6，虽然它已被微软抛弃很久了，但是由于大天朝的特殊行情（盗版）对于前端工程师来说，解决IE6兼容position:fixed的问题显得很重要。特别是你需要用到头尾悬停调用的时候
2015-04-04
Bootstrap每天必学之前端开发框架
Bootstrap每天必学之前端开发框架，今天这篇文章就带着大家了解认识当下最流行的前端开发框架Bootstrap，bootstrap深受大家喜爱的原因到底是什么呢，我们一探究竟。
2015-11-11