Qt Quick Controls でサポートされている環境変数
このページには、Qt Quick Controlsがサポートするすべての環境変数のリストが記載されています。これらの環境変数は主にテスト目的で用意されていますが、システム全体のデフォルト設定を行うためにも使用できます。
| 変数 | 説明 |
|---|---|
QT_QUICK_CONTROLS_STYLE | Qt Quick Controls のデフォルトのスタイルを指定します。値には、"Material" などの組み込みスタイル、または"MyStyle" などのカスタムスタイルを指定できます。 |
QT_QUICK_CONTROLS_FALLBACK_STYLE | カスタムスタイルのフォールバックスタイルを指定します。値には、組み込みスタイル（例："Material" ）のいずれか、 |
QT_QUICK_CONTROLS_CONF | Qt Quick Controls の設定ファイルの場所を指定します。デフォルトでは、設定ファイルはアプリケーションのリソース内の":/qtquickcontrols2.conf" から読み込まれます。 |
QT_QUICK_CONTROLS_HOVER_ENABLED | Qt Quick Controls が `hover effects` を使用するかどうかを指定します。値として `0 ` または `1 ` を設定することで、それぞれホバー効果を無効化または有効化できます。 |
スタイル固有の環境変数を想像してみてください：
| 変数 | 説明 |
|---|---|
QT_QUICK_CONTROLS_IMAGINE_PATH | Imagineスタイルのアセットが含まれるディレクトリへのパスを指定します。指定しない場合は、組み込みのアセットが使用されます。 たとえば、リソースシステムに保存されているディレクトリへのパスを指定するには： ローカルディレクトリへの相対パスを指定するには： 注： 技術的な制限により 、 |
QT_QUICK_CONTROLS_IMAGINE_SMOOTH | 9-patch 画像のスムーズなスケーリングを有効にするには、1 に設定してください。この環境変数は Qt 6.5 で追加されました。 |
マテリアルスタイル固有の環境変数：
| 変数 | 説明 |
|---|---|
QT_QUICK_CONTROLS_MATERIAL_THEME | デフォルトのMaterialテーマを指定します。値には利用可能なテーマのいずれかを指定できます（例："Dark" ）。 |
QT_QUICK_CONTROLS_MATERIAL_VARIANT | Materialのバリアントを指定します。Material Designには、タッチデバイス向けに設計された「normal」バリアントと、デスクトップ向けの「dense」バリアントの2種類があります。「dense」バリアントでは、コントロールやフォントのサイズが小さくなります。 値として、 |
QT_QUICK_CONTROLS_MATERIAL_ACCENT | Materialのデフォルトのアクセント色を指定します。値は任意のcolor を指定できますが、"Teal"などの事前定義されたMaterialカラーのいずれかを使用することを推奨します。 |
QT_QUICK_CONTROLS_MATERIAL_PRIMARY | Materialのデフォルトのプライマリカラーを指定します。値は任意のcolor に設定できますが、"BlueGrey" など、あらかじめ定義されたMaterialカラーのいずれかを使用することを推奨します。 |
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND | Materialのデフォルトの前景色を指定します。値は任意のcolor にできますが、"Brown"などの定義済みのMaterialカラーのいずれかを使用することを推奨します。 |
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND | Materialのデフォルトの背景色を指定します。値は任意のcolor 、または"Grey"などの定義済みのMaterialカラーのいずれかです。 |
ユニバーサルスタイル固有の環境変数:
| 変数 | 説明 |
|---|---|
QT_QUICK_CONTROLS_UNIVERSAL_THEME | デフォルトのユニバーサルテーマを指定します。値として、利用可能なテーマのいずれか（例："Dark" ）を指定できます。 |
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT | デフォルトのユニバーサルアクセント色を指定します。値は任意のcolor に設定できますが、"Violet"などの事前定義されたユニバーサルカラーのいずれかを使用することを推奨します。 |
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND | デフォルトのユニバーサル前景色を指定します。値は任意のcolor または、"Brown" などの事前定義されたユニバーサルカラーのいずれかです。 |
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND | デフォルトのユニバーサル背景色を指定します。値としては、任意のcolor 、または"Steel"などの事前定義されたユニバーサルカラーのいずれかを指定できます。 |
関連情報
© 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.
