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 对象内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Bootstrap中的fileinput 多图片上传及编辑功能
这篇文章主要介绍了Bootstrap中的fileinput 多图片上传及编辑功能的实现,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-09-09
BootStrap 导航条实例代码
本文通过实例代码给大家介绍了bootstrap导航条效果，代码简单易懂，非常不错，具有参考借鉴价值，需要的的朋友参考下吧
2017-05-05
微信小程序input、textarea层级过高穿透的问题解决
微信小程序原生组件camera、canvas、input、live-player、live、pusher、map、textarea、video的层级是最高的，那么如何解决微信小程序input、textarea层级过高穿透，本文就详细的介绍一下
2021-11-11
Javascript实现从小到大的数组转换成二叉搜索树
这篇文章主要介绍了Javascript实现从小到大的数组转换成二叉搜索树的相关资料,需要的朋友可以参考下
2017-06-06
详解js中构造流程图的核心技术JsPlumb
这篇文章主要介绍了js中构造流程图的核心技术JsPlumb，jsPlumb是一个强大的JavaScript连线库，它可以将html中的元素用箭头、曲线、直线等连接起来，适用于开发Web上的图表、建模工具等，需要的朋友可以参考下
2015-12-12
把字符串按照特定的字母顺序进行排序的js代码
把字符串按照特定的字母顺序进行排序，下面有个不错的示例，大家可以参考下
2014-01-01
SOSO地图JS画出标注和中心点以html形式运行
SOSO地图想必大家都知道吧，本文将为大家详细介绍下使用JS画出标注和中心点,直接贴出代码，感兴趣的朋友可以参考下
2013-08-08
TypeScript中declare关键字的具体使用
declare关键字用来告诉编译器,某个类型是存在的,可以在当前文件中使用,本文主要介绍了TypeScript中declare关键字的具体使用,感兴趣的可以了解一下
2023-10-10
webpack学习教程之前端性能优化总结
webpack是近期最火的一款模块加载器兼打包工具，它能把各种资源，例如JS（含JSX）、coffee、样式（含less/sass）、图片等都作为模块来使用和处理。这篇文章主要给大家总结介绍了关于webpack学习教程之前端性能优化的相关资料，需要的朋友可以参考下。
2017-12-12
uni-app中实现元素拖动效果
这篇文章主要介绍了uni-app中实现元素拖动效果,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2024-01-01