Qt Quick Controls
Qt Quick Controls は、Qt Quick で完全なインターフェイスを構築するために使用できるコントロールのセットを提供します。
Qt Quick Controls にはカスタマイズ可能なスタイルが用意されています。詳しくはStylingQt 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 を参照してください。
ボタンコントロール
ボタンに共通する機能を提供する抽象的な基本型 | |
クリックしてコマンドを実行したり、質問に答えたりできるプッシュボタン | |
オン/オフの切り替えが可能なチェックボタン | |
長く押し続けるとトリガーされるチェックボタン | |
オン/オフの切り替えが可能な専用ラジオボタン | |
ユーザーがクリックできる角丸のプッシュボタンコントロール | |
オン/オフの切り替えが可能なボタン | |
ツールバーに適した外観を持つボタン |
コンテナ・コントロール
ヘッダーとフッターをサポートするスタイル付きトップレベルウィンドウ | |
コンテナに共通する機能を提供する抽象的な基本型 | |
論理的なコントロールグループのビジュアルフレーム | |
論理的なコントロールグループのビジュアルフレームとタイトル | |
TableViewに付随する水平ヘッダービューの提供 | |
ヘッダーとフッターをサポートするスタイル付きページコントロール | |
アプリケーションのスタイルとテーマにマッチした背景を提供 | |
スクロール可能なビュー | |
各項目間にドラッグ可能なスプリッタを使用して項目をレイアウトします。 | |
スタックベースのナビゲーションモデル | |
横スワイプによるページ移動が可能 | |
異なるビューやサブタスク間の切り替えが可能 | |
コンテキスト依存コントロールのコンテナ | |
TableViewに付随する垂直ヘッダービューを提供 |
デリゲートコントロール
オン/オフの切り替えが可能なチェック・インジケータを備えた項目デリゲート | |
さまざまなビューやコントロールで使用できる基本的なアイテムデリゲート | |
オン/オフの切り替えが可能なラジオインジケータを持つ排他的項目デリゲート | |
スワイプ可能な項目デリゲート | |
オン/オフの切り替えが可能なスイッチ・インジケータを持つ項目デリゲート | |
TableViewに割り当てることができるデリゲート | |
TreeViewに割り当てることができるデリゲート | |
インジケータ・コントロール
コンテンツがロードされている間など、バックグラウンドでの活動を示す | |
現在アクティブなページを示す | |
操作の進行状況を示す | |
垂直または水平のインタラクティブスクロールバー | |
垂直または水平の非対話型スクロールインジケータ |
入力コントロール
オプションを選択するためのボタンとポップアップリストの組み合わせ | |
値を設定するために回す円形ダイヤル | |
プリセットされた浮動小数点値のセットから選択可能 | |
トラックに沿って2つのハンドルをスライドさせることにより、値の範囲を選択するために使用される | |
検索機能用に設計された特殊な入力フィールド | |
トラックに沿ってハンドルをスライドさせて値を選択するために使用されます。 | |
プリセット値のセットから選択可能 | |
複数行テキスト入力エリア | |
1行テキスト入力フィールド | |
選択可能な項目の回転可能なホイール |
メニューコントロール
付属のタイプは、プラットフォームに適した方法でコンテキストメニューを開く方法を提供します。 | |
コンテキストメニューまたはポップアップメニューとして使用できるポップアップ | |
ウィンドウメニューバーを提供します | |
MenuBar内にドロップダウンメニューを表示します。 | |
メニュー内の項目を表示します |
ナビゲーションコントロール
スワイプジェスチャーで開閉できるサイドパネル | |
スタックベースのナビゲーションモデル | |
横スワイプによるページ移動が可能 | |
異なるビューまたはサブタスク間の切り替えが可能 | |
タブバーに適した外観のボタン |
ポップアップコントロール
標準的なボタンとタイトルを持つポップアップダイアログ。 | |
スワイプジェスチャーで開閉できるサイドパネル | |
コンテキストメニューやポップアップメニューとして使用できるポップアップ | |
ポップアップのようなユーザー・インターフェース・コントロールの基本タイプ | |
あらゆるコントロールにツールヒントを提供 |
セパレータコントロール
メニュー内の項目グループを隣接する項目から分離する | |
ツールバーの項目グループを隣接する項目から分離する |
モジュールの進化
Qt Quick Controls は、もともとタッチ・インターフェースを主な対象として書かれた。デスクトップ・インターフェースの開発はすでに可能ですが、よりネイティブなルック＆フィールを提供するための作業が進行中です。
Qt Quick Controls の変更点には、Qt 6 シリーズの Qt のために行われた、モジュール API と機能の重要な変更点が記載されています。
バージョニングスキーム Qt Quick Controls で使われているバージョニングスキームについて説明しています。
記事とガイド
使用例
リファレンス
関連モジュール
ライセンス
Qt Quick Controls は、The Qt Companyの商用ライセンスの下で入手可能です。さらに、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。詳細はQt ライセンスを参照してください。
さらに、Qt Quick Controls は、以下の寛容なライセンスのサードパーティモジュールを含む可能性があります：
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
