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" ） を指定できます。

©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。