本页内容

Qt Quick

Qt Quick 模块是编写QML应用程序的标准库。虽然 Qt Qml 模块提供 QML 引擎和语言基础设施,Qt Quick 模块则提供了使用 QML 创建用户界面所需的所有基本类型。它提供了一个可视化画布,并包含用于创建和动画化可视化组件、接收用户输入、创建数据模型和视图以及延迟对象实例化的类型。

Qt Quick 模块同时提供了QML API (用于通过QML语言创建用户界面的QML类型)和C++ API (用于通过C++代码扩展QML应用程序)。

注意: 还提供了一套 基于Qt Quick 的用户界面控件,可用于创建用户界面。请参阅 Qt Quick Controls 以获取更多信息。

如果您是 QML 和Qt Quick 的新手,请参阅《QML 应用程序》以了解编写 QML 应用程序的入门知识。

在项目中使用该模块

访问 QML API

可通过QtQuick 导入语句使用该模块的 QML 类型。要使用这些类型,请在您的 .qml 文件中添加以下导入语句:

import QtQuick

在您的 C++ 项目中

要使用 Qt 模块的 C++ API,需要将模块库链接到项目中,既可以直接链接,也可以通过其他依赖项间接链接。包括CMake和qmake 在内的多种构建工具都为此提供了专门的支持。

使用 CMake 构建

使用 `find_package() ` 命令在 `Qt6 ` 包中定位所需的模块组件:

find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)

更多详细信息,请参阅“使用 CMake 构建”概述。

使用 qmake 构建

要配置模块以便使用 qmake 进行构建,请在项目的 .pro 文件中将该模块作为QT 变量的值添加:

QT += quick

中的重要概念Qt Quick

Qt Quick 提供了创建具有流畅且动态用户界面的丰富应用所需的一切。它使您能够围绕用户界面组件的行为及其相互连接方式来构建用户界面,并提供了一个具有自身坐标系和渲染引擎的可视化画布。 动画和过渡效果是Qt Quick 中的核心概念,您可以通过专用的粒子效果和着色器效果组件添加视觉效果。

在使用Qt Quick 模块时,您需要了解如何使用QML语言编写QML应用程序。特别是请参阅“QML应用程序”页面中的《QML基础》和《QML精要》。

如需进一步了解如何使用 QML 语言,请参阅 Qt Qml 模块文档。

C++ 扩展点

文章与指南

示例

参考

  • Qt Quick C++ Classes - 由Qt Quick 模块提供的C++ API
  • Qt Quick QML Types - 由 `QtQuick ` 导入提供的 QML 类型列表
    • Effects - 提供可应用于Qt Quick 项的 Graphical Effects
    • Local Storage - 一个包含 SQLite 数据库 JavaScript 接口的子模块
    • Particles - 提供用于Qt Quick
    • 布局- 为排列Qt Quick 项提供布局
    • Tests - 包含用于编写 QML 应用程序单元测试的类型
    • Shapes - 提供用于在Qt Quick 场景中渲染矢量图形的类型。
    • Vector Image - 提供用于显示矢量图像文件的类型。
  • Qt Quick Android 类- 提供用于将 QML 与 Java/Kotlin Android API 结合使用的类。

Qt Academy 课程

许可与署名

Qt Quick 由The Qt Company 提供商业许可。此外,还提供自由软件许可。自 Qt 5.4 起,这些自由软件许可包括GNU 较少通用公共许可证第 3 版或GNU 通用公共许可证第 2 版。更多详情请参阅Qt 许可。

此外,Qt 6.12.0 中的Qt Quick 可能包含遵循以下宽松许可协议的第三方模块:

Yoga, version 2.0.1

MIT 许可证

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.