目录
Qt Quick Controls中受支持的环境变量
- 此页面包含Qt Quick Controls支持的所有环境变量的列表。
- 环境变量主要用于测试目的,但是它们也可以用于设置系统范围的默认值。
QT_QUICK_CONTROLS_STYLE
指定默认的Qt Quick Controls样式。该值可以是例如内置样式之一,也可以是 "Material"
自定义样式的路径,例如":/mystyle"
。QT_QUICK_CONTROLS_FALLBACK_STYLE
指定自定义样式的后备样式。该值可以是内置样式之一,例如 "Material"
,QT_QUICK_CONTROLS_STYLE_PATH
指定用于查找Qt Quick Controls样式的其他路径的列表。多路径条目必须分开以 ':'
Unix下和';'
Windows下。默认情况下,样式是从中查找的$QML2_IMPORT_PATH/QtQuick/Controls.2
。QT_QUICK_CONTROLS_CONF
指定Qt Quick Controls配置文件的位置。默认情况下,配置文件是从中的应用程序资源加载的 ":/qtquickcontrols2.conf"
。QT_QUICK_CONTROLS_HOVER_ENABLED
指定Qt Quick Controls是否使用悬停效果。该值可以分别设置为 0
或1
禁用或启用悬停效果。
Imagine style 特定于样式的环境变量:
QT_QUICK_CONTROLS_IMAGINE_PATH
指定包含Imagine样式资产的目录的路径。如果未指定,则使用内置资产。
例如,要指定存储在资源系统中的目录的路径:
QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets
要指定本地目录的相对路径:
QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets
注意:由于技术限制,如果路径相对于文件,则不应将其命名为“ imagine”
qtquickcontrols2.conf
。
Material style特定于样式的环境变量:
QT_QUICK_CONTROLS_MATERIAL_THEME
指定默认的Material主题。该值可以是可用主题之一,例如 "Dark"
。QT_QUICK_CONTROLS_MATERIAL_VARIANT
指定材料变体。材质设计有两个变体:为触摸设备设计的普通变体和为台式机设计的密集变体。密集变体对控件及其字体使用较小的尺寸。
该值可以是
"Normal"
或"Dense"
。QT_QUICK_CONTROLS_MATERIAL_ACCENT
指定默认的“材质”强调颜色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一 "Teal"
。QT_QUICK_CONTROLS_MATERIAL_PRIMARY
指定默认的Material原色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一 "BlueGrey"
。QT_QUICK_CONTROLS_MATERIAL_FOREGROUND
指定默认的“材质前景色”。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一 "Brown"
。QT_QUICK_CONTROLS_MATERIAL_BACKGROUND
指定默认的“材质”背景色。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一 "Grey"
。
Universal style特定于样式的环境变量:
QT_QUICK_CONTROLS_UNIVERSAL_THEME
指定默认的通用主题。该值可以是可用主题之一,例如 "Dark"
。QT_QUICK_CONTROLS_UNIVERSAL_ACCENT
指定默认的通用强调颜色。该值可以是任何颜色,但是建议使用例如预定义的通用颜色之一 "Violet"
。QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND
指定默认的Universal前景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一 "Brown"
。QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND
指定默认的通用背景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一 "Steel"
。
Styling Qt Quick Controls
可用样式
- Qt Quick Controls带有多种样式。
Default Style
- 该默认样式是一种简单,重量轻,全方位的风格,提供了Qt Quick的控制最大性能。
Fusion Style
- 该Fusion Style是一个平台无关的风格,提供了一个面向桌面的look'n'feel Qt的快速控制。
Imagine Style
- Imagine Style 基于图像, 该样式带有一组默认的图像,可以通过使用预定义的命名约定为目录提供图像来轻松更改这些图像。
Material Style
- Material Style 基于一个有吸引力的设计谷歌材质设计准则,但需要比默认样式更多的系统资源。
Universal Style
- Universal Style 提供基于对一个有吸引力的设计,微软通用设计准则,但需要比默认样式更多的系统资源。
在Qt Quick Controls中使用样式
- 为了运行具有特定样式的应用程序,请使用C ++中的QQuickStyle配置样式,传递命令行参数或设置环境变量。
- 或者,可以在配置文件中指定首选的样式和样式特定的属性。
- 这些方法的优先级按照从高到低的顺序在下面列出。
- 也就是说,例如,QQuickStyle用于设置样式始终比使用命令行参数具有更高的优先级。
- 警告:将给定样式名称解析为绝对路径时,QQuickStyle可能会搜索根资源目录(:)。
- 因此,请确保资源目录的名称与应用程序支持的样式的名称不同。否则,样式可能无法加载。
- 例如,避免命名一个资源目录:/material(或:/Material)如果应用程序支持的Material风格。
使用QQuickStyle 在C++中
- QQuickStyle提供了用于配置特定样式的C ++ API。以下示例使用Material样式运行Qt Quick Controls应用程序:
QQuickStyle::setStyle("Material");
- 有关更多详细信息,请参见QQuickStyle的详细描述。
命令行参数
- 传递
-style
命令行参数是测试不同样式的便捷方法。- 它优先于下面列出的其他方法。以下示例使用Material样式运行Qt Quick Controls应用程序:
./app -style material
环境变量
- 设置
QT_QUICK_CONTROLS_STYLE
环境变量可用于设置系统范围的样式首选项。- 它优先于下面提到的配置文件。以下示例以通用样式运行Qt Quick Controls应用程序:
QT_QUICK_CONTROLS_STYLE=universal ./app
- 有关受支持的环境变量的完整列表,请参见Qt Quick Controls中的受支持的环境变量。
配置文件
- Qt Quick Controls支持一个特殊的配置文件
:/qtquickcontrols2.conf
,该文件内置于应用程序的资源中。- 配置文件可以指定首选样式(可以由前面描述的任何一种方法覆盖)和某些样式特定的属性。下面的示例指定首选样式为“Material ”样式。
[Controls] Style=Material
- 有关配置文件的更多详细信息,请参见Qt Quick Controls配置文件。