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）的样式都必须提供一个 Menu.qml 文件，且该文件中的根项必须是来自Qt Quick Templates 中的 Menu。当您导入QtQuick.Controls 并在 QML 中创建一个菜单时，所获得的类型实际上是由该样式对应的 Menu.qml 文件定义的 QML 菜单。

若要在属性声明中将某个控件用作类型，应使用来自Qt Quick 模板库中的对应类型。例如，假设有一个PopupOpener 组件，它是一个可打开弹出窗口的 Button：

// 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 模板中的 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 指南