Qt Quick Controls 設定ファイル
Qt Quick Controls は、アプリケーションのリソースに組み込まれる特別な構成ファイル「qtquickcontrols2.conf 」をサポートしています。
この設定ファイルでは、優先スタイルや特定のスタイル固有の属性を指定できます。次の例では、優先スタイルとして「Material」スタイルを指定しています。 さらに、アプリケーションが Material スタイルで実行される場合、テーマは「ライト」になり、アクセントカラーとプライマリカラーはそれぞれティールとブルーグレーになります。一方、アプリケーションがUniversal スタイルで実行される場合、アクセントカラーは赤になり、システムのテーマカラーに基づいて適切なテーマが選択されます。
[Controls]
Style=Material
[Universal]
Theme=System
Accent=Red
[Material]
Theme=Light
Accent=Teal
Primary=BlueGrey環境変数QT_QUICK_CONTROLS_CONFを使用すると、設定ファイルの保存場所をカスタムで指定することができます。
Controls セクション
設定ファイルの `Controls ` セクションでは、以下の値を指定できます。
| 変数 | 説明 |
|---|---|
Style | アプリケーションの実行に使用するスタイルを指定します。値には、組み込みスタイルのいずれかの名前、またはカスタムスタイルを指定できます。 |
FallbackStyle | 実装されていないコントロールに使用するスタイルを指定します。このスタイルは、組み込みスタイルのいずれかでなければなりません。デフォルトでは、Basicスタイルが使用されます。 |
Imagineセクション
次の表は、設定ファイルのImagine セクションでImagineスタイルを構成するために使用できる値の一覧です。
| 変数 | 説明 |
|---|---|
Path | Imagineスタイルのアセットが含まれるディレクトリへのパスを指定します。指定しない場合は、組み込みのアセットが使用されます。 たとえば、リソースシステムに保存されているディレクトリへのパスを指定するには： ローカルディレクトリへの相対パスを指定するには： 注： 技術的な制限により 、 |
マテリアルセクション
以下の表は、設定ファイルのMaterial セクションにおいて、Material スタイルを設定するために使用できる値の一覧です：
| 変数 | 説明 |
|---|---|
Theme | デフォルトのMaterialテーマを指定します。値には、利用可能なテーマのいずれか（例："Dark" ）を指定できます。 |
Variant | Materialのバリアントを指定します。Material Designには、タッチデバイス向けに設計された「normal」バリアントと、デスクトップ向けの「dense」バリアントの2種類があります。「dense」バリアントでは、コントロールやフォントのサイズが小さくなります。 値として、 |
Accent | Materialのデフォルトのアクセント色を指定します。値は任意のcolor を指定できますが、"Teal"などの事前定義されたMaterialカラーのいずれかを使用することを推奨します。 |
Primary | Materialのデフォルトのプライマリカラーを指定します。値は任意のcolor に設定できますが、"BlueGrey" など、あらかじめ定義されたMaterialカラーのいずれかを使用することを推奨します。 |
Foreground | Materialのデフォルトのフォアグラウンド色を指定します。値は任意のcolor に設定できますが、"Brown" などの事前定義されたMaterialカラーのいずれかを使用することを推奨します。 |
Background | Materialのデフォルトの背景色を指定します。値は任意のcolor 、または"Grey" などの事前定義されたMaterialの色を指定できます。 |
ユニバーサルセクション
以下の表は、設定ファイルのUniversal セクションでUniversalスタイルを設定するために使用できる値の一覧です：
| 変数 | 説明 |
|---|---|
Theme | デフォルトのユニバーサルテーマを指定します。値は利用可能なテーマのいずれか（例："Dark" ）に設定できます。 |
Accent | デフォルトのユニバーサルアクセント色を指定します。値は任意のcolor にできますが、"Violet"などの事前定義されたユニバーサルカラーのいずれかを使用することを推奨します。 |
Foreground | デフォルトのユニバーサル前景色を指定します。値は任意のcolor または、"Brown" などの事前定義されたユニバーサルカラーのいずれかです。 |
Background | デフォルトのユニバーサル背景色を指定します。値としては、任意のcolor 、または"Steel"などの定義済みのユニバーサルカラーのいずれかを指定できます。 |
フォント設定
デフォルトのfont は、設定ファイル内の各スタイルのセクションにあるFont サブグループで指定できます：
[Basic]
Font\Family=Open Sans
Font\PixelSize=20サポートされているフォント属性：
| 変数 | 説明 |
|---|---|
Family | font family 。 |
PointSize | point size 。 |
PixelSize | pixel size 。 |
StyleHint | style hint 。使用可能な値：SansSerif 、Helvetica 、Serif 、Times 、TypeWriter 、Courier 、OldEnglish 、Decorative 、Monospace 、Fantasy 、Cursive 。 |
Weight | weight 。Qtでは、OpenTypeと互換性のある1 から1000 までのウェイトスケールを使用しています。1 のウェイトは「薄め」となり、1000 は「極めて太い」となります。 利用可能な定義済みウェイト：Thin (100)、ExtraLight (200)、Light (300)、Normal (400)、Medium (500)、DemiBold (600)、Bold (700)、ExtraBold (800)、Black (900)。 |
Style | style 。使用可能な値：StyleNormal 、StyleItalic 、StyleOblique 。 |
パレットの設定
デフォルトのpalette は、設定ファイル内のPalette サブグループを使用して、スタイルごとに設定できます。Palette サブグループは、次の2つの方法で定義できます：
[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121詳細については、Palette QML タイプを参照してください。
プロジェクトでの設定ファイルの使用
Qt Quick Controls が設定ファイルを検出できるようにするには、Qt リソースシステムを使用して、その設定ファイルをアプリケーションのリソースに組み込む必要があります。以下に、.qrc ファイルの例を示します：
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
<file>qtquickcontrols2.conf</file>
</qresource>
</RCC>注: Qt Quick コントロールは、ファイルセレクタを使用して設定ファイルをロードします。プラットフォームやロケールごとに異なる設定ファイルを指定することが可能です。詳細については、QFileSelector のドキュメントを参照してください。
最後に、.qrc ファイルをアプリケーションのビルドファイルに記述する必要があります。例：
set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
application.qrc
main.cpp
...
)RESOURCES = application.qrc
...関連項目：ビルドシステムの統合
関連情報
© 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.
