Qt Quick Controls

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

Qt Quick Controls 该模块提供了一系列可定制的样式。更多详情，请参阅样式Qt Quick Controls 。

使用模块

QML API

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

import QtQuick.Controls

C++ 应用程序接口

使用 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 2.0 在 Qt 5.7 中引入。随后发布的 Qt 次版本将 模块的导入版本递增一个，直到 Qt 5.12，导入版本与 Qt 的次版本一致。Qt Quick Controls

在 Qt 6 中，主版本和次版本都匹配，QML 中的导入可以省略版本号。如果省略了版本号，将使用最新版本。

Qt Labs 实验模块使用导入版本 1.0。

修订

由于Qt Quick Controls 的实现方式，添加的新属性可能会与用户定义的同名属性发生冲突。例如，以下代码段将导致错误：

import QtQuick.Controls 2.13

ApplicationWindow {
    // ...

    ComboBox {
        anchors.centerIn: parent

        // As currentValue was added in 2.14, the versioned import above
        // should cause this property to be used, but instead an error is produced:
        // "Cannot override FINAL property"
        property int currentValue: 0
    }
}

这些属性应重新命名，以避免冲突。

模块进化

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

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

文章和指南

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

实例

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

参考资料

• 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 许可。

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