Qt Quick Controls QML Types

Qt Quick Controlsは、ユーザーインターフェースを作成するための QML タイプを提供します。これらの QML タイプは、Qt QuickやQt Quick Layouts と連携して動作します。

Qt Quick Controls の QML タイプは、.qml ファイルの以下の import 文を使用してアプリケーションにインポートすることができます：

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を作成すると、実際に得られる型はスタイルのMenu.qmlで定義されたQML Menuになります。

コントロールをプロパティ宣言の型として使用するには、Qt Quick Templatesの対応する型を使用する必要があります。例えば、PopupOpener 、Popupを開く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 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 ガイドライン