QML 对象类型

QML 对象类型是可以从中实例化 QML 对象的类型。

In syntactic terms, a QML object type is one which can be used to declare an object by specifying the type name followed by a set of curly braces that encompasses the attributes of that object. This differs from 值类型 , which cannot be used in the same way. For example, Rectangle is a QML object type: it can be used to create Rectangle type objects. This cannot be done with primitive types such as int and bool , which are used to hold simple data types rather than objects.

Custom QML object types can be defined by creating a .qml file that defines the type, as discussed in Documents as QML object type definitions , or by defining a QML type from C++ and registering the type with the QML engine, as discussed in 从 C++ 定义 QML 类型 . Note that in both cases, the type name must begin with an uppercase letter in order to be declared as a QML object type in a QML file.

For more information about C++ and the different QML integration methods, see the C++ 和 QML 集成概述页面。

从 QML 定义对象类型

透过 QML 文档定义对象类型

Plugin writers and application developers may provide types defined as QML documents. A QML document, when visible to the QML import system, defines a type identified by the name of the file minus the file extensions.

Thus, if a QML document named "MyButton.qml" exists, it provides the definition of the "MyButton" type, which may be used in a QML application.

See the documentation about QML 文档 for information on how to define a QML document, and the syntax of the QML language. Once you are familiar with the QML language and how to define QML documents, see the documentation which explains how to 在 QML 文档中定义和使用自己的可重用 QML 类型 .

见透过 QML 文档定义对象类型了解更多信息。

采用组件定义匿名类型

Another method of creating object types from within QML is to use the Component type. This allows a type to be defined inline within a QML document, instead of using a separate document in a .qml 文件。

Item {
    id: root
    width: 500; height: 500
    Component {
        id: myComponent
        Rectangle { width: 100; height: 100; color: "red" }
    }
    Component.onCompleted: {
        myComponent.createObject(root)
        myComponent.createObject(root, {"x": 200})
    }
}

Here the myComponent object essentially defines an anonymous type that can be instantiated using Component::createObject to create objects of this anonymous type.

Inline components share all the characteristics of regular top-level components and use the same import list as their containing QML document.

Note that each Component object declaration creates its own component scope . Any id values used and referred to from within a Component object declaration must be unique within that scope, but do not need to be unique within the document within which the inline component is declared. So, the Rectangle declared in the myComponent object declaration could have an id of root without conflicting with the root declared for the Item object in the same document, as these two id values are declared within different component scopes.

见作用域和命名分辨率了解更多细节。

从 C++ 定义对象类型

C++ plugin writers and application developers may register types defined in C++ through API provided by the Qt QML module. There are various registration functions which each allow different use-cases to be fulfilled. For more information about those registration functions, and the specifics of exposing custom C++ types to QML, see the documentation regarding 从 C++ 定义 QML 类型 .

The QML type-system relies on imports, plugins and extensions being installed into a known import path. Plugins may be provided by third-party developers and reused by client application developers. Please see the documentation about QML 模块 for more information about how to create and deploy a QML extension module.