Qt Quick Controls

Qt Quick Controls 提供可以用于构建 Qt Quick 完整界面的一套控件。模块在 Qt 5.7 引入。

Qt Quick Controls 带有可定制选择风格。见 风格化 Qt Quick Controls 了解更多细节。

使用模块

QML API

QML 类型 可以使用以下 import 语句导入应用程序,在 .qml 文件:

import QtQuick.Controls
							

C++ API

使用 C++ API 要求直接或透过其它依赖链接到模块库。一些构建工具对此提供专用支持,包括 CMake 和 qmake。

构建采用 CMake

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

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

另请参阅 构建采用 CMake 概述。

采用 qmake 构建

要配置采用 qmake 构建模块,把模块作为 Qt 变量的值添加到工程 .pro 文件中:

QT += quickcontrols2
							

从源代码构建

Qt Image Formats 模块是推荐的,但不要求。它提供支持为 .webp 格式使用通过 想象风格 .

版本

Qt Quick Controls 2.0 was introduced in Qt 5.7. Subsequent minor Qt releases increment the import version of the Qt Quick Controls modules by one, until Qt 5.12, where the import versions match Qt's minor version.

In Qt 6, both the major and minor versions match, and version numbers may be omitted from imports in QML. If the version is omitted, the latest version will be used.

The experimental Qt Labs modules use import version 1.0.

Qt QtQuick QtQuick.Controls ,
QtQuick.Controls.Material ,
QtQuick.Controls.Universal ,
QtQuick.Templates
Qt.labs.platform
5.7 2.7 2.0 1.0
5.8 2.8 2.1 1.0
5.9 2.9 2.2 1.0
5.10 2.10 2.3 1.0
5.11 2.11 2.4 1.0
5.12 2.12 2.12 1.0
6.0 6.0 6.0 1.0
... ... ... ...

模块演变

Qt Quick Controls 的变化 列出了 Qt 的 Qt 6 系列在模块 API 和功能方面所做出的重要改变。

许可和归属

Qt Quick Controls 在商业许可下是可用的来自 Qt 公司 。此外,它是可用的在 GNU LGPL (次一般公共许可) 第 3 版 ,或 GNU GPL (一般公共许可) 第 2 版 。见 Qt 许可 进一步了解细节。

此外,Qt Quick Controls 潜在包含的第 3 方模块遵循以下准许许可:

话题

参考

范例