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_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-patch 图像的平滑缩放功能。该环境变量于 Qt 6.5 版本中新增。

Material 样式专用的环境变量：

变量描述
QT_QUICK_CONTROLS_MATERIAL_THEME指定默认的Material 主题。该值可以是可用主题之一，例如"Dark" 。
QT_QUICK_CONTROLS_MATERIAL_VARIANT指定 Material 的变体。Material Design 有两种变体：一种是为触控设备设计的标准变体，另一种是适用于桌面的紧凑变体。紧凑变体采用较小的控件尺寸及其字体。

其值可以是"Normal" 或"Dense" 。

QT_QUICK_CONTROLS_MATERIAL_ACCENT指定默认的Material 强调色。该值可以是任何color ，但建议使用预定义的 Material 颜色之一，例如"Teal" 。
QT_QUICK_CONTROLS_MATERIAL_PRIMARY指定默认的Material 主色。该值可以是任何color ，但建议使用预定义的 Material 颜色之一，例如"BlueGrey" 。
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND指定默认的Material 前景色。该值可以是任何color ，或预定义的 Material 颜色之一，例如"Brown" 。
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND指定Material 的默认前景色。该值可以是任何color ，或预定义的 Material 颜色之一，例如"Grey" 。

通用样式特定的环境变量：

变量描述
QT_QUICK_CONTROLS_UNIVERSAL_THEME指定默认的Universal 主题。该值可以是可用主题之一，例如"Dark" 。
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT指定默认的Universal 强调色。该值可以是任意color ，但建议使用预定义的 Universal 颜色之一，例如"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.