本页内容

Qt Qml 设计支持

Qt Qml 的设计支持模块通过提供一组类型,支持在QML中注册和引用对象。对象在注册时通过键字符串进行标识,引用类型可利用这些键获取已注册对象的引用。 其设计理念是实现 UI 代码与业务逻辑的清晰分离,特别是在 UI 代码由工具自动生成且不期望开发人员手动修改的情况下。Qt Qml 设计支持模块同时提供了QML API和C++ API用于引用已注册的对象。对象注册功能仅通过QML API 提供。

Qt Qml 设计支持模块于Qt 6.12版本中引入。

使用该模块

QML API

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

import QtQml.DesignSupport

Qt Qml 设计支持模块的QML API提供了注册 QML 对象以及引用已注册 QML 对象所需的类型。

C++ API

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

Qt Qml 设计支持模块的C++ API提供了引用已注册QML对象所需的类。

使用 CMake 进行构建

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

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

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

使用 qmake 构建

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

QT += qmldesignsupport

API 参考

许可与归属

Qt Qml 设计支持由The Qt Company 提供商业许可。此外,它还遵循GNU 较少通用公共许可证第 3 版或GNU 通用公共许可证第 2 版。更多详细信息请参阅Qt 许可。

© 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.