Qt Quick 控件 QML 类型

Qt Quick 控件 提供用于创建用户界面的 QML 类型。这些 QML 类型与 Qt Quick 和 Qt Quick Layouts 一起使用。

您可以使用以下导入语句将 Qt Quick 控件 QML 类型导入到您的 .qml 文件中

import QtQuick.Controls

QML 类型

在属性声明中使用 Qt Quick 控制类型

如Qt Quick Templates 2 QML 类型所述，Qt Quick Controls 中的每个类型都由 Qt Quick Templates 中的 C++ "模板" 类型支持。这些类型是控件逻辑和行为的非可视实现。

例如，Menu 类型的 API 和行为由 Qt Quick Templates 中的 C++ 类型定义。每个样式都希望提供菜单，都必须有一个可用的 Menu.qml，并且该文件中的根项必须是 Qt Quick Templates 中的 Menu。当您导入 QtQuick.Controls 并在 QML 中创建一个菜单时，您得到的类型实际上是由样式的 Menu.qml 定义的 QML 菜单。

为了将控件用作属性声明中的类型，您应使用 Qt Quick Templates 中的相应类型。例如，假设您有一个 PopupOpener 组件，它是一个打开弹出窗口的按钮

// PopupButton.qml
import QtQuick.Controls

Button {
    required property Popup popup

    onClicked: popup.open()
}

// main.qml
PopupButton {
    popup: saveChangesDialog
}

Dialog {
    id: saveChangesDialog

    // ...
}

运行此代码将导致错误

Unable to assign Dialog_QMLTYPE to Popup_QMLTYPE

这是因为继承层次结构

Popup (C++ type in QtQuick.Templates)
│   └── Popup (QML type in QtQuick.Controls)
└── Dialog (C++ type in QtQuick.Templates)
    └── Dialog (QML type in QtQuick.Controls)

QtQuick.Controls 的 Dialog 不从 QtQuick.Controls 的 Popup 继承，而是从 QtQuick.Templates 继承。

相反，将 Qt Quick Templates 中的 Popup 用作属性类型

// PopupButton.qml
import QtQuick.Controls
import QtQuick.Templates as T

Button {
    required property T.Popup popup

    onClicked: popup.open()
}

有关 Qt Quick Controls 模块的更多信息，请参阅Qt Quick Controls 模块文档。

相关信息

• Qt Quick Controls 指南