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是否使用悬停效果。该值可以设置为
0
或1
,分别禁用或启用悬停效果。
想象风格 特定的环境变量:
变量
描述
QT_QUICK_CONTROLS_IMAGINE_PATH
指定包含Imagine样式资源的目录路径。如果未指定,则使用内置资源。
例如,指定存储在资源系统中的目录路径:
QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets指定本地目录的相对路径:
QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets注意
由于技术限制,如果路径相对于
qtquickcontrols2.conf
文件,则不应命名为“imagine”。
QT_QUICK_CONTROLS_IMAGINE_SMOOTH
设置为
1
以启用9-patch图像的平滑缩放。此环境变量在Qt 6.5中添加。
Material style 特定的环境变量:
变量
描述
QT_QUICK_CONTROLS_MATERIAL_THEME
指定默认的Material主题。该值可以是可用主题之一,例如
"Dark"
。
QT_QUICK_CONTROLS_MATERIAL_VARIANT
指定Material变体。Material Design有两种变体:一种是为触摸设备设计的普通变体,另一种是为桌面设计的密集变体。密集变体使用较小的控件尺寸和字体。
值可以是
"Normal"
或"Dense"
。
QT_QUICK_CONTROLS_MATERIAL_ACCENT
指定默认的Material强调色。该值可以是任何颜色,但建议使用预定义的Material颜色之一,例如
"Teal"
。
QT_QUICK_CONTROLS_MATERIAL_PRIMARY
指定默认的Material 主色。该值可以是任何颜色,但建议使用预定义的 Material 颜色之一,例如
"BlueGrey"
。
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND
指定默认的Material前景色。该值可以是任何颜色,或者是预定义的Material颜色之一,例如
"Brown"
。
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND
指定默认的Material背景颜色。该值可以是任何颜色,或者是预定义的Material颜色之一,例如
"Grey"
。
通用样式 特定环境变量:
变量
描述
QT_QUICK_CONTROLS_UNIVERSAL_THEME
指定默认的Universal theme。该值可以是可用的主题之一,例如
"Dark"
。
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND
指定默认的Universal前景色。该值可以是任何颜色,或者是预定义的Universal颜色之一,例如
"Brown"
。
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND