QML类型说明-Component

Component

ImportStatement:   import QtQml 2.2

Instantiates:     QQmlComponent

 

Properties

progress :real

status :enumeration

url : url

 

Attached Signals

completed()

destruction()

 

Methods

objectcreateObject(Item parent, object properties)

stringerrorString()

objectincubateObject(Item parent, object properties, enumeration mode)

 

Detailed Description

这个组件是可重用的,有着良好接口的QML封装类型。Components常常被组件文件定义。组件文件是.qml文件。Component类型本质上允许在一个QML文档定义内联组件,而不是用单独的QML文件。组件有益于在一个QML文件中重用小组件或者在。qml中定义可被其他QML文件使用的组件。

例如,这里有个被多次装载的组件,它包含单一项Rectangle:

import QtQuick2.0

 

Item {

    width: 100; height: 100

 

    Component {

        id: redSquare

 

        Rectangle {

            color: "red"

            width: 10

            height: 10

        }

    }

 

    Loader { sourceComponent: redSquare }

    Loader { sourceComponent: redSquare; x: 20}

}

注意Rectangle能被自己渲染和显示,但这不是上面的Rectangle显示的理由。因为它被定义在一个Component内部,就像使用单独的QML文件定义,如果不加载,它就不显示。因为组件不是Item的派生,所以我们没有办法锚定到它。

定义组件和定义QML文档相似。一个QML文档有一个顶层的Item,它定义了组件的行为和属性。不能在顶层Item的外面定义任何属性或行为。与之相同,一个组件定义包含一个单一的顶层Item。(上面的例子中是Rectangle),除了id标识,不能在Item的外面定义任何数据。(上面的例子中是redSquare)

Component常常用来为显示提供一个图形组件。例如ListView::delegate属性需要一个组件来指明列表中的项应该如何显示。Component也能被Qt.createComponent()动态的创建。

 

创建内容:

组件的创建内容对应于组件被宣布的内容。当组件被一个诸如ListView或Loader的对象实例化,这个内容被用作父内容层次结构的创建。

在下面的例子中,comp1在MyItem.qml的根内容上创建,在这个组件的任何对象实例中,都可访问ids和属性,比如internalSettings.color。当comp1被用在另一个内容(如main.qml下)中ListView的delegate属性上时,它依旧能访问MyItem.qml的创建内容,但这些内容对main.qml的其他内容来说,是私有的。

MyItem.qml

Item {

    property Component mycomponent: comp1

 

    QtObject {

        id: internalSettings

        property color color: "green"

    }

 

    Component {

        id: comp1

        Rectangle { color:internalSettings.color; width: 400; height: 50 }

    }

}

 

main.qml

ListView {

    width: 400; height: 400

    model: 5

    delegate: myItem.mycomponent    //will create green Rectangles

 

    MyItem { id: myItem }

}

 

Property Documentation

progress :real

加载组件的进展,从0.0(未加载)到1.0(完成加载)。

 

status :enumeration

组件的加载状态,它是下面的值之一:

Component.Null- 没有数据可利用

Component.Ready- 组件加载完毕,能创建实例。

Component.Loading- 组件正在被加载。

Component.Error- 加载组件发生错误,errorString()提供了可阅读的错误描述。

 

url : url

用于构造组件的URL。

 

AttachedSignal Documentation

completed()

在组件启动完成之后发射这个信号。这被用来在完整的QML环境建立后,执行启动脚本代码。响应的操作句柄是onCompleted。它能在任何对象中宣部,onCompleted的运行次序是未定义的。

Rectangle {

    Component.onCompleted:console.log("Completed Running!")

    Rectangle {

        Component.onCompleted:console.log("Nested Completed Running!")

    }

}

 

destruction()

当组件被摧毁时,发射这个信号。它能用来撤销在completed()信号上响应的工作或者我们应用其他必要处理的工作。操作句柄是onDestruction。它能被任何对象宣布。注意:onDestruction被用于组件整体被摧毁,而不是一个具体的对象。其运行的次序是未定义的。

Rectangle {

    Component.onDestruction:console.log("Destruction Beginning!")

    Rectangle {

        Component.onDestruction:console.log("Nested Destruction Beginning!")

    }

}

 

Method Documentation

objectcreateObject(Item parent, object properties)

用parent和properties创建并返回一个组件的实例。properties参数是可选的,如果创建失败,则返回空。创建对象的内容和组件被创建时一致。如果调用的组件不是在QML中创建的,则这个函数总是返回空。

如果我们希望创建不设置父母的对象,指定parent的值为空。注意如果返回的对象需要被显示,我们必须提供有效的父母值或设置返回对象的父母属性,否则对象将不可见。如果父母没有在createObject()的时候被提供,返回对象的引用则被保留而不会被垃圾收集器摧毁。这是真的不管,无论Item::parent是否被设置。这是因为设置Item parent没有改变对象的拥有者,仅仅是显示控制的父被改变。

在QtQuick 1.1,这个方法接受可选择的属性参数,它是创建实例的初始化属性值的映射。这些值在对象创建结束前被设置比创建之后设置更有效率,特别对大型属性值的定义,效率提升的更明显。同时它也允许属性在对象创建之前绑定(使用Qt.binding)。

properties是对象的属性值的映射,例如下面的代码,使用x为100,y为100创建一个对象。

varcomponent = Qt.createComponent("Button.qml");

if(component.status == Component.Ready)

    component.createObject(parent,{"x": 100, "y": 100});

动态创建的实例,能被destroy()方法摧毁。更多信息参阅《Dynamic QML Object Creation from JavaScript》

 

stringerrorString()

返回错误的描述。这个信息包含文件,路经和错误的描述。如果多个错误吹按,他们被放在新行。如果没有错误发生,它是空字符。

 

objectincubateObject(Item parent, object properties, enumeration mode)

为组件的实例创建孵化器。孵化器允许我们异步创建组件的实例,这么做不会阻塞UI。

parent指明了创建的实例的父,该参数允许为空,标识没有父。在这种情况下,实例的引用被保留,而不会被垃圾收集器摧毁。properties参数是实例被构造是,用来初始化属性的值的映射。模式为Qt.Synchronous或Qt.Asynchronous,用来控制我们同步还是异步创建实例。默认是异步的。在某些情况下,即使Qt.Synchronous被设置,实例依然异步创建。这发生在调用incubateObject()的组件实例本身就被异步创建的时候。

3个参数都是可选的。

如果成功,该方法返回一个孵化器对象,否则为空。孵化器有下面的属性:

status:孵化期的状态,有效值是Component.Ready、Component.Loading和Component.Error。

object Thecreated object instance:仅仅当孵化期在Ready状态有效,为孵化器创建的实例。

onStatusChanged:状态变化时指定的回调,status作为参数传递。

forceCompletion():该调用使孵化器同步完成。

下面的例子展示了如何使用孵化器:

 

varcomponent = Qt.createComponent("Button.qml");

 

varincubator = component.incubateObject(parent, { x: 10, y: 10 });

if(incubator.status != Component.Ready) {

    incubator.onStatusChanged =function(status) {

        if (status == Component.Ready) {

            print ("Object",incubator.object, "is now ready!");

        }

    }

} else {

    print ("Object",incubator.object, "is ready immediately!");

}

动态创建的实例,能被destroy()方法摧毁。更多信息参阅《Dynamic QML Object Creation from JavaScript》

你可能感兴趣的:(QML类型说明-C)