Qt Quick Controls

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

Qt Quick Controls comes with a selection of customizable styles. See 风格化 Qt Quick Controls 了解更多细节。

使用模块

QML API

模块的 QML 类型是可用的透过 QtQuick.Controls 导入。要使用类型,添加以下 import 语句到 .qml 文件:

import QtQuick.Controls
					

C++ API

使用 Qt 模块的 C++ API 要求直接 (或透过其它依赖) 链接到模块库。几个构建工具对此有专用支持,包括 CMake and qmake .

构建采用 CMake

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

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

更多细节,见 构建采用 CMake 概述。

采用 qmake 构建

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

QT += quickcontrols2
					

从源代码构建

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

Revisions

Due to how Qt Quick Controls are implemented, new properties that are added may clash with any user-defined properties of the same name. For example, the following snippet will result in an error:

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
    }
}
					

These properties should be renamed to avoid the conflict.

模块演变

Qt Quick Controls was originally written with touch interfaces as the primary focus. While it is already possible to develop desktop interfaces, work is ongoing to provide a more native look and feel.

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

文章和指南

范例

参考

许可和归属

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

Furthermore, Qt Quick Controls potentially contains third party modules under the following permissive licenses:

有角材质的阴影值

MIT 许可