一个QML文档就是一个符合QML文档语法的字符串,它定义了一个QML对象类型。QML文档通常从存储在本地或远程的.qml文件进行加载,也可以在代码中进行手动构建。这一点在前面已经介绍过。
文档中定义的对象类型的实例可以在QML代码中使用Component(组件)进行创建,也可以在C++中使用QQmlComponent进行创建。另外,如果这个对象类型使用一个特定的类型名称被显式地暴露给QML类型系统,那么这个类型就可以在其他文档的对象声明中直接使用。因为在文档中可以定义可重复使用的QML对象类型,所以在客户端可以编写出模块化的、高可读性的、易于维护的代码。
一个QML文档包含两部分:import导人语句和一个单一的根对象声明构成的对象树。需要强调的是,一个QML文档只能包含一个根对象声明,不允许出现两个平行的根对象。按照惯例,在这两部分之间需要留有一空行进行分隔。QML文档一般使用UTF-8格式进行编码。对于本节内容,读者可以在Qt帮助中通过QMLDocu-ments关键字查看。
4.6.1通过QML文档定义对象类型