Qt Quick Controls QML Types

Qt Quick Controls提供了用于创建用户界面的 QML 类型。这些 QML 类型与 Qt Quick和Qt Quick Layouts 配合使用。

Qt Quick Controls 可在 .qml 文件中使用以下导入语句将 QML 类型导入应用程序：

import QtQuick.Controls

QML 类型

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

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

例如，Menu 类型的 API 和行为是由Qt Quick Templates 中的 C++ 类型定义的。每个想要提供菜单的样式都必须有一个可用的 Menu.qml，该文件的根项必须是Qt Quick Templates 中的菜单。当你导入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 指南