Qt Quick Controls

Qt Quick Controls は、 で完全なインターフェイスを構築するために使用できるコントロールのセットを提供します。このモジュールは Qt 5.7 で導入されました。Qt Quick

Qt Quick Controls には、カスタマイズ可能なスタイルが用意されています。詳細はスタイリングQt Quick Controls を参照してください。

モジュールを使う

QML API

モジュールの QML タイプはQtQuick.Controls のインポートから利用できます。この型を使用するには、.qml ファイルに以下の import 文を追加してください：

import QtQuick.Controls

C++ API

Qt モジュールの C++ API を使用するには、モジュール・ライブラリに対して直接、または他の依存関係を介してリンクする必要があります。CMakeや qmakeなど、いくつかのビルドツールはこのための専用サポートを持っています。

CMakeでのビルド

find_package() コマンドを使って、Qt6 パッケージの中から必要なモジュールコンポーネントを探します：

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

詳細については、CMakeによるビルドの概要を参照してください。

qmakeによるビルド

モジュールをqmakeでビルドするように設定するには、プロジェクトの.proファイルにQT 変数の値としてモジュールを追加します：

QT += quickcontrols2

ソースからのビルド

この Qt Image Formatsモジュールの使用を推奨する。このモジュールは、Imagineスタイルで使用される.webp フォーマットのサポートを提供します。

コントロール

Qt Quick Controls の全リストはQML Types を参照。

ボタンコントロール

コンテナ・コントロール

委譲コントロール

インジケーターコントロール

入力コントロール

メニューコントロール

ナビゲーションコントロール

ポップアップコントロール

セパレーターコントロール

バージョン

Qt Quick Controls 2.0 は Qt 5.7 で導入されました。それ以降の Qt のマイナーリリースでは、 モジュールのインポートバージョンが 1 つずつ増加し、Qt 5.12 ではインポートバージョンが Qt のマイナーバージョンと一致するようになりました。Qt Quick Controls

Qt 6では、メジャーバージョンとマイナーバージョンの両方が一致し、QMLのインポートではバージョン番号を省略することができます。バージョンが省略された場合は、最新のバージョンが使用されます。

実験的なQt Labsのモジュールでは、importのバージョンは1.0を使用しています。

改訂

Qt Quick Controls の実装方法により、新しく追加されたプロパティは、同じ名前のユーザー定義プロパティと衝突する可能性があります。例えば、以下のスニペットはエラーになります：

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

これらのプロパティは、衝突を避けるために名前を変更する必要があります。

モジュールEvolution

Qt Quick Controls はもともと、タッチ・インターフェースを主な対象として書かれました。デスクトップ・インターフェースを開発することはすでに可能ですが、よりネイティブなルック＆フィールを提供するための作業が進行中です。

Qt Quick Controls の変更点には、Qt 6 シリーズの Qt のために行われた、モジュール API と機能の重要な変更が記載されています。

記事とガイド

• はじめに
• ガイドライン
• スタイリング
• アイコン
• カスタマイズ
• ファイル・セレクタの使用
• デプロイメント
• 設定ファイル
• 環境変数

使用例

• ギャラリー
• チャットチュートリアル
• テキストエディタ
• ウェアラブルデモ
• 自動車の例
• すべての例

リファレンス

• QML Types
• C++ Classes

関連モジュール

• Qt Quick
• Qt Quick レイアウト
• Qt Quick テンプレート2
• Qt Labs Platform

ライセンス

Qt Quick Controls はQt Companyの商用ライセンスで利用できます。また、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。詳細はQt ライセンスを参照してください。

さらに、Qt Quick Controls は、以下の寛容なライセンスのサードパーティモジュールを含む可能性があります：