Back to Qt.io
Contact Us Blog Download Qt

でサポートされている環境変数Qt Quick Controls

このページには、Qt Quick Controls がサポートしているすべての環境変数のリストが含まれています。環境変数は主にテスト用ですが、システム全体のデフォルトを設定するためにも使用できます。

変数説明
QT_QUICK_CONTROLS_STYLEデフォルトのQt Quick Controls スタイルを指定する。この値には、例えば"Material" のような組み込みスタイルか、"MyStyle" のようなカスタムスタイルのいずれかを指定します。
QT_QUICK_CONTROLS_FALLBACK_STYLEカスタム・スタイルのフォールバック・スタイルを指定します。値には、組み込みスタイルのいずれかを指定します （例 ："Material" ）、
QT_QUICK_CONTROLS_CONFQt Quick Controls 構成フ ァ イ ルの場所を指定 し ます。デフォルトでは、構成ファイルはアプリケーションのリソースから":/qtquickcontrols2.conf" に読み込まれます。
QT_QUICK_CONTROLS_HOVER_ENABLEDQt Quick Controls がhover effects を使用するかどうかを指定します。この値を0 または1 に設定することで、それぞれホバー効果を無効または有効にすることができます。

スタイル固有の環境変数を想像してください：

変数説明
QT_QUICK_CONTROLS_IMAGINE_PATHImagine スタイル アセットを含むディレクトリへのパスを指定します。指定しない場合は、組み込みのアセットが使用されます。

例えば、リソース・システムに保存されているディレクトリへのパスを指定します：

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

ローカル ディレクトリへの相対パスを指定する場合：

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

注： 技術的な制限により、qtquickcontrols2.conf ファイルからの相対パスの場合、"imagine" という名前にすべきではありません。

QT_QUICK_CONTROLS_IMAGINE_SMOOTH9-patch イメージのスムーズなスケーリングを有効にするには、1 に設定します。この環境変数は Qt 6.5 で追加されました。

マテリアル・スタイル固有の環境変数

変数説明
QT_QUICK_CONTROLS_MATERIAL_THEMEデフォルトのMaterial テーマを指定します。値は利用可能なテーマの一つで、例えば"Dark" 。
QT_QUICK_CONTROLS_MATERIAL_VARIANTMaterial バリアントを指定します。Material Design には 2 つのバリアントがあります: タッチデバイス用にデザインされた通常のバリアントと、デスクトップ用の dense バリアントです。密なバリアントは、コントロールとそのフォントに小さいサイズを使用します。

値は"Normal" または"Dense" です。

QT_QUICK_CONTROLS_MATERIAL_ACCENTデフォルトのマテリアルアクセントカラーを指定します。値にはcolor のいずれかを指定できますが、事前に定義されているマテリアルの色のいずれかを使用することをお勧めします（例："Teal" ）。
QT_QUICK_CONTROLS_MATERIAL_PRIMARYデフォルトの「素材」の原色を指定します。値には任意のcolor を指定できますが、事前に定義された「素材」の色の 1 つを使用することをお勧めします（例："BlueGrey" ）。
QT_QUICK_CONTROLS_MATERIAL_FOREGROUNDデフォルトのマテリアルの前景色を指定します。値には任意のcolor を指定できますが、事前に定義された「素材」の色の 1 つ（例："Brown" ）を使用することをお勧めします。
QT_QUICK_CONTROLS_MATERIAL_BACKGROUNDデフォルトの素材の背景色を指定します。値には任意のcolor 、または事前に定義されたマテリアルの色の1つ（例："Grey" ）を指定できます。

ユニバーサルスタイル固有の環境変数：

変数変数 説明
QT_QUICK_CONTROLS_UNIVERSAL_THEMEデフォルトのユニバーサルテーマを指定します。値には、使用可能なテーマの 1 つを指定できます (例:"Dark")。
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTデフォルトのUniversalアクセントカラーを指定します。値にはcolor のいずれかを指定で きますが、事前に定義された Universal カラーの 1 つを使用することを推奨します（例："Violet" ）。
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUNDUniversal のデフォルトの前景色を指定します。値には任意のcolor 、または事前定義済みの Universal カ ラ ーのいずれか 1 つを指定で き ます （例 ："Brown" ）。
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUNDデフォルトのUniversal 背景色を指定します。値には、任意のcolor 、または事前定義済みの Universal カラーの 1 つ （例 ："Steel" ） を指定できます。

© 2025 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.