Qt 5.12--Qt QML语法
1 简介
QML是用于创建高度动态应用程序的多范式语言。 使用QML,可以声明应用程序构建块(如UI组件),并设置各种属性来定义应用程序行为。 可以通过JavaScript(该语言的子集)进一步编写应用程序行为脚本。 此外,QML大量使用Qt,Qt允许直接从QML应用程序访问类型和其他Qt功能。
2 基本语法
2.1 Import 说明
导入语句允许客户端告诉引擎QML文档中使用了哪些模块,JavaScript资源和组件目录。 文档中可以使用的类型取决于文档导入的模块,资源和目录。
QML定义了 3 种不同的导入类型
2.1.1 模块(命名空间)导入
最常见的导入类型是模块导入。 客户端可以导入QML模块,这些模块将QML对象类型和JavaScript资源注册到给定的名称空间中。
模块导入的通用形式如下:
import <ModuleIdentifier> <Version.Number> [as <Qualifier>]
example:
import QtQuick 2.0
该导入允许使用QtQuick模块提供的所有类型,而无需指定限定符。
import QtQuick 2.0
Rectangle {
width: 200
height: 100
color: "red"
}
为了避免不同模块之间的命名冲突,我们在导入模块时可以使用“as”关键字设置该模块在本 qml 文件中的“别名”。
import QtQuick 2.0 as Quick
Quick.Rectangle {
width: 200
height: 100
color: "red"
}
如果要求使用两个具有相同名称但位于不同模块中的QML类型,则使用命名空间导入非常有用。 在这种情况下,可以将两个模块导入不同的名称空间,以确保代码引用正确的类型:
import QtQuick 2.0 as CoreItems
import "../textwidgets" as MyModule
CoreItems.Rectangle {
width: 100; height: 100
MyModule.Text { text: "Hello from my custom text item!" }
CoreItems.Text { text: "Hello from Qt Quick!" }
}
将多个模块导入全局命名空间的方式与将多个模块导入同一命名空间的方式相同。
import QtQuick 2.0 as Project
import QtMultimedia 5.0 as Project
Project.Rectangle {
width: 100; height: 50
Project.Audio {
source: "music.wav"
autoPlay: true
}
}
2.1.2 目录导入
包含QML文档的目录也可以直接导入QML文档中。 这为将QML类型划分为可重用的分组提供了一种简单的方法:
import "<DirectoryPath>" [as <Qualifier>]
2.1.3 JavaScript资源导入
2.1.4 别名("as"规则说明)
为了避免不同模块之间的命名冲突,我们在导入模块时可以使用“as”关键字设置该模块在本 qml 文件中的“别名”。
为了保证 Qt 内部组件和命名空间不被污染以及保持代码可以顺利升级–比如升级 Qt 版本,需要确保不对 Qt 模块设置别名,而对其他,比如HUI、Roshan以及其他三方的或者项目内的模块,进行“别名”处理。尤其是那些对常见控件进行定制的模块。
- 导入Qt内置模块的版本号为对应的Qt版本的最高版本号。
- js文件导入到qml中必须要有别名。
- 在导入模块中,本身就有命名冲突时,需给其中至少一个模块都设置别名
- 不对 Qt 内置模块设置别名
- 对于自定义模块需设置别名
- 别名作为模块在所属 qml 文件中的代号,需保持文件内的唯一性
- 别名的命名规则采用“大驼峰”
2.1.5 非模块命名空间导入
类型也可以直接通过C ++中的各种注册函数(例如qmlRegisterType())注册到名称空间中。 可以通过导入名称空间来导入已以此方式注册到名称空间中的类型,就好像该名称空间是模块标识符一样。
int qmlRegisterType()
这是一个重载功能。
该模板函数在QML系统中注册C ++类型。 无法从QML系统创建此类型的实例。
当不按名称引用类型时,应使用此函数。 具体来说,它必须用于用作属性绑定左侧的C ++类型。
3 QML对象属性
参考
1、The QML Reference
2、Quick–简介
3、qml编码规范与指导
4、qmlRegisterType
5、