中支持的环境变量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_PATH=:/imagine-assets 指定本地目录的相对路径： QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets 注意：由于技术限制，如果路径是`qtquickcontrols2.conf` 文件的相对路径，则不应命名为"imagine"。
`QT_QUICK_CONTROLS_IMAGINE_SMOOTH`	设置为`1` 可启用 9 补丁图像的平滑缩放。此环境变量在 Qt 6.5 中添加。

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 补丁图像的平滑缩放。此环境变量在 Qt 6.5 中添加。

材质样式特定环境变量：

变量	说明
`QT_QUICK_CONTROLS_MATERIAL_THEME`	指定默认材质主题。该值可以是可用主题之一，例如`"Dark"` 。
`QT_QUICK_CONTROLS_MATERIAL_VARIANT`	指定 Material 变体。Material Design 有两个变体：一个是为触摸设备设计的普通变体，另一个是为桌面设计的密集变体。密集变体使用较小尺寸的控件及其字体。该值可以是`"Normal"` 或`"Dense"` 。
`QT_QUICK_CONTROLS_MATERIAL_ACCENT`	指定默认材质强调色。该值可以是color ，但建议使用预定义的材质颜色，例如`"Teal"` 。
`QT_QUICK_CONTROLS_MATERIAL_PRIMARY`	指定默认材质主色调。该值可以是任何color ，但建议使用其中一种预定义的材质颜色，例如`"BlueGrey"` 。
`QT_QUICK_CONTROLS_MATERIAL_FOREGROUND`	指定默认材质前景色。该值可以是任何color ，也可以是预定义的材质颜色之一，例如`"Brown"` 。
`QT_QUICK_CONTROLS_MATERIAL_BACKGROUND`	指定默认材质背景色。该值可以是任何color ，也可以是预定义的材质颜色之一，例如`"Grey"` 。

通用样式特定环境变量：

变量	说明
`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"` 。

使用文件选择器配置文件

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

中支持的环境变量Qt Quick Controls

相关信息