Qt 5.12--Qt QML语法

最新推荐文章于 2025-04-22 08:51:20 发布

worthsen

最新推荐文章于 2025-04-22 08:51:20 发布

阅读量3.7k

点赞数 2

分类专栏： quick Qt-5.12

本文链接：https://blog.csdn.net/qq_38880380/article/details/103790622

版权

Qt-5.12 同时被 2 个专栏收录

23 篇文章

订阅专栏

quick

20 篇文章

订阅专栏

本文深入解析Qt5.12中的QML语法，涵盖基本语法、模块导入、目录及JavaScript资源导入等内容，同时探讨QML对象属性的使用，适合QML开发者学习与参考。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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以及其他三方的或者项目内的模块，进行“别名”处理。尤其是那些对常见控件进行定制的模块。