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 来分别禁用或启用悬停效果。

Imagine 风格 特定的环境变量

变量描述
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 设计有两个变体：一个适用于触摸设备的普通变体，和一个适用于桌面的紧凑变体。紧凑变体使用更小的控件和字体大小。

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

QT_QUICK_CONTROLS_MATERIAL_ACCENT指定默认的 Material 色调颜色。值可以是任意 颜色，但建议使用预定义的 Material 颜色，例如 "Teal"。
QT_QUICK_CONTROLS_MATERIAL_PRIMARY指定默认的 Material 主色。值可以是任何 颜色，但建议使用其中之一 预定义的 Material 颜色，例如 "蓝灰"。
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND指定默认的 Material 前景色。值可以是任何 颜色，或其中之一 预定义的 Material 颜色，例如 "棕色"。
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND指定默认的 Material 背景色。值可以是任何 颜色，或其中之一 预定义的 Material 颜色，例如 "灰色"。

通用样式特定的环境变量

变量描述
QT_QUICK_CONTROLS_UNIVERSAL_THEME指定默认的 通用主题。值可以是可用的主题之一，例如 "深色"。
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT指定默认的 通用强调颜色。值可以是任何 颜色，但建议使用其中之一 预定义的 Universal 颜色，例如 "紫色"。
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND指定默认的 通用前景色。值可以是任何 颜色，或其中之一 预定义的 Universal 颜色，例如 "棕色"。
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND指定默认的 通用背景色。值可以是任何 颜色，或其中之一 预定义的 Universal 颜色，例如 "钢蓝"。

© 2024 Qt 公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 许可的。Qt 及其相关标志是芬兰的 Qt 公司和/或全球其他国家的商标。所有其他商标均为各自所有者财产。