Qt Quick コントロール
Qt Quick 「Controls」は、Qt Quick で完全なインターフェースを構築するために使用できる一連のコントロールを提供します。
Qt Quick 「Controls」には、カスタマイズ可能なスタイルがいくつか用意されています。詳細については、「 Qt Quick コントロールのスタイル設定」を参照してください。
モジュールの使用方法
QML API
このモジュールの QML タイプは、QtQuick.Controls インポートを通じて利用できます。これらのタイプを使用するには、.qml ファイルに次のインポート文を追加してください。
import QtQuick.ControlsC++ 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 コントロールの完全なリストについては、QML Types を参照してください。
ボタンコントロール
ボタンに共通する機能を提供する抽象基底型 | |
クリックしてコマンドを実行したり、質問に答えたりできるプッシュボタン | |
オンまたはオフに切り替え可能なチェックボタン | |
一定時間押し続けるとトリガーされるチェックボタン | |
オン／オフを切り替え可能な排他的ラジオボタン | |
ユーザーがクリックできる、角が丸いプッシュボタンコントロール | |
オンまたはオフに切り替え可能なボタン | |
ツールバーに適した外観のボタン |
コンテナコントロール
ヘッダーとフッターをサポートした、スタイルが適用されたトップレベルウィンドウ | |
コンテナに共通する機能を提供する抽象基底型 | |
コントロールの論理的なグループを表すビジュアルフレーム | |
コントロールの論理グループを表す視覚的な枠とタイトル | |
TableViewに付随する水平方向のヘッダービューを提供する | |
ヘッダーとフッターをサポートするスタイル設定済みのページコントロール | |
アプリケーションのスタイルやテーマに合わせた背景を提供する | |
スクロール可能なビュー | |
各アイテムの間にドラッグ可能なスプリッターを配置してアイテムをレイアウトします | |
スタックベースのナビゲーションモデルを提供します | |
ユーザーが横方向にスワイプしてページ間を移動できるようにします | |
ユーザーが異なるビューやサブタスクを切り替えられるようにします | |
コンテキストに応じたコントロールのコンテナ | |
TableViewに付随する縦型ヘッダービューを提供します |
デリゲートコントロール
オン／オフを切り替え可能なチェックインジケーターを備えたアイテムデリゲート | |
さまざまなビューやコントロールで使用できる基本的なアイテムデリゲート | |
オン／オフを切り替え可能なラジオインジケーターを備えた専用のアイテムデリゲート | |
スワイプ可能なアイテムデリゲート | |
オン／オフを切り替え可能なスイッチインジケーターを備えたアイテムデリゲート | |
TableViewに割り当て可能なデリゲート | |
TreeViewに割り当て可能なデリゲート | |
インジケーターコントロール
コンテンツの読み込み中など、バックグラウンドでの処理を通知します | |
現在アクティブなページを示す | |
操作の進行状況を示す | |
縦または横のインタラクティブなスクロールバー | |
縦または横の非インタラクティブなスクロールインジケーター |
入力コントロール
オプションを選択するためのボタンとポップアップリストの組み合わせ | |
値を設定するために回転させる円形のダイヤル | |
ユーザーが、あらかじめ設定された浮動小数点値のセットから選択できるようにする | |
トラックに沿って2つのハンドルをスライドさせて値の範囲を選択するために使用される | |
検索機能用に設計された専用の入力フィールド | |
トラックに沿ってハンドルをスライドさせて値を選択するために使用される | |
ユーザーがあらかじめ設定された値のセットから選択できるようにする | |
複数行のテキスト入力領域 | |
1行のテキスト入力フィールド | |
選択可能な項目が並んだ回転可能なホイール |
メニューコントロール
「Attached」タイプは、プラットフォームに適した方法でコンテキストメニューを開く手段を提供します | |
コンテキストメニューまたはポップアップメニューとして使用できるポップアップ | |
ウィンドウのメニューバーを提供します | |
MenuBar内にドロップダウンメニューを表示します | |
メニュー内に項目を表示します |
ナビゲーションコントロール
スワイプジェスチャーで開閉できるサイドパネル | |
スタックベースのナビゲーションモデルを提供します | |
ユーザーが横方向にスワイプしてページ間を移動できるようにする | |
ユーザーが異なるビューやサブタスクを切り替えられるようにする | |
TabBarにふさわしい外観のボタン |
ポップアップコントロール
標準的なボタンとタイトルを備えたポップアップダイアログ。ユーザーとの短期的なインタラクションに使用されます | |
スワイプ操作で開閉できるサイドパネル | |
コンテキストメニューやポップアップメニューとして使用できるポップアップ | |
ポップアップのようなユーザーインターフェースコントロールの基本タイプ | |
任意のコントロールに対してツールチップを提供する |
セパレータコントロール
メニュー内のアイテムのグループを、隣接するアイテムから区切る | |
ツールバー内の項目のグループを、隣接する項目から区切ります |
モジュールの進化
Qt Quick Controlsは当初、タッチインターフェースを主眼として開発されました。現在ではデスクトップインターフェースの開発も可能ですが、よりネイティブな外観と操作感を実現するための開発が進行中です。
「Qt Quick Controls の変更点」では、Qt 6 シリーズ向けに実施されたモジュール API および機能に関する重要な変更点を一覧しています。
バージョン管理方式では、Qt Quick Controls で採用されているバージョン管理方式について説明しています。
記事とガイド
例
リファレンス
関連モジュール
ライセンスおよび帰属表示
Qt Quick Controlsは、The Qt Companyから商用ライセンスで提供されています。また、GNU Lesser General Public License（バージョン3） またはGNU General Public License（バージョン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.
