Qt Quick 控件

Qt Quick Controls 提供了一组控件，可用于在Qt Quick 中构建完整的界面。

Qt Quick Controls 提供了一系列可定制的样式。详情请参阅样式Qt Quick Controls。

使用模块

QML API

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

import QtQuick.Controls

C++ API

使用 Qt 模块的 C++ API 需要直接或通过其他依赖关系与模块库链接。一些编译工具对此提供了专门支持，包括CMake和qmake。

使用 CMake 构建

使用find_package() 命令在Qt6 软件包中找到所需的模块组件：

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

更多详情，请参阅使用 CMake 构建概述。

使用 qmake 构建

要配置模块以便用 qmake 构建，请在项目的 .pro 文件中添加模块作为QT 变量的值：

QT += quickcontrols2

从源代码构建

推荐使用 Qt Image Formats模块是推荐使用的，但并非必需。它支持Imagine 风格使用的.webp 格式。

控件

有关Qt Quick 控件的完整列表，请参见QML Types 。

按钮控件

容器控件

委托控件

指示器控件

输入控件

菜单控件

导航控件

弹出控件

分隔控件

模块演变

Qt Quick Controls 最初是以触摸界面为主要重点编写的。虽然现在已经可以开发桌面界面，但仍在努力提供更原生的外观和感觉。

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

版本方案描述了Qt Quick Controls 所使用的版本方案。

文章和指南

• 入门
• 指南
• 样式
• 图标
• 自定义
• 使用文件选择器
• 部署
• 配置文件
• 环境变量

实例

• 图库
• 聊天教程
• 文本编辑器
• 可穿戴设备演示
• 汽车示例
• 所有示例

参考资料

• QML Types
• C++ Classes

相关模块

• Qt Quick
• Qt Quick 布局
• Qt Quick 模板 2
• Qt Labs Platform

许可和归属

Qt Quick Controls 可在The Qt Company 的商业许可下使用。此外，它还可以在GNU Lesser General Public License 第 3 版或GNU General Public License 第 2 版下使用。有关详细信息，请参阅Qt Licensing。

此外，Qt Quick Controls 可能包含以下许可下的第三方模块：