Qt Quick Controls

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

Qt Quick Controls 提供了多种可自定义的样式。更多详情请参阅《 Qt Quick Controls 样式设置》。

使用该模块

QML API

可通过QtQuick.Controls 导入语句使用该模块的QML类型。要使用这些类型，请在您的.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 Controls 的完整列表，请参阅QML Types 。

按钮控件

容器控件

委托控件

指示器控件

输入控件

菜单控件

导航控件

弹出控件

分隔符控件

模块演进

Qt Quick Controls 最初开发时主要侧重于触控界面。虽然目前已经可以开发桌面界面，但相关工作仍在进行中，旨在提供更接近原生应用的外观和操作体验。

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

版本号方案描述了Qt Quick Controls 采用的版本号方案。

文章与指南

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

示例

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

参考

• QML Types
• C++ Classes

相关模块

• Qt Quick
• Qt Quick Layouts
• Qt Quick 模板 2
• Qt Labs Platform

许可与归属

Qt Quick Controls 由The Qt Company 提供商业许可。此外，它还遵循GNU 较宽松通用公共许可证第 3 版或 GNU 通用公共许可证第 2 版。更多详细信息请参阅Qt 许可。

此外，Qt Quick Controls 可能包含遵循以下宽松许可协议的第三方模块：