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

注意

由于技术限制，路径名称不应为 “imagine”，如果它是相对于 qtquickcontrols2.conf 文件的相对路径。

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

指定默认的材质强调颜色。值可以是任何颜色，但建议使用预定义的材质颜色之一，例如 "Teal"。

QT_QUICK_CONTROLS_MATERIAL_PRIMARY

指定默认的材质主颜色。值可以是任何颜色，但建议使用预定义的材质颜色之一，例如 "BlueGrey"。

QT_QUICK_CONTROLS_MATERIAL_FOREGROUND

指定默认的材质前景颜色。值可以是任何颜色，或使用预定义的材质颜色之一，例如 "Brown"。

QT_QUICK_CONTROLS_MATERIAL_BACKGROUND

指定默认的材质背景颜色。值可以是任何颜色，或使用预定义的材质颜色之一，例如 "Grey"。

通用样式特定的环境变量

变量

描述

QT_QUICK_CONTROLS_UNIVERSAL_THEME

指定默认的通用主题。值可以是可用的主题之一，例如 "Dark"。

QT_QUICK_CONTROLS_UNIVERSAL_ACCENT

指定默认的通用强调颜色。值可以是任何颜色，但建议使用预定义的通用颜色之一，例如 "Violet"。

QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND

指定默认的通用前景颜色。值可以是任何颜色，或使用预定义的通用颜色之一，例如 "Brown"。

QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND

指定默认的通用背景颜色。值可以是任何颜色，或使用预定义的通用颜色之一，例如 "Steel"。