Qt Quick Controls 配置文件
- Qt Quick Controls支持一个特殊的配置文件
qtquickcontrols2.conf
,该文件内置于应用程序的资源中。- 配置文件可以指定首选样式和某些样式特定的属性。
- 下面的示例指定首选样式为Material样式。
- 此外,当应用程序以“材质”样式运行时,其主题为浅色,强调色和原色分别为蓝绿色和蓝灰色。
- 但是,如果应用程序改用通用样式运行,则强调色为红色,并根据系统主题色选择适当的主题。
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
- 可以使用 QT_QUICK_CONTROLS_CONF 环境变量为配置文件指定自定义位置。
Controls Section
- 可以
Controls
在配置文件的一部分中指定以下值:
Style
指定运行应用程序的样式。该值可以是内置样式或自定义样式之一的名称。 FallbackStyle
指定用于未实现的控件的样式。样式必须是内置样式之一。默认情况下,使用默认样式。
Imagine Section
- 下表在配置文件的一部分中列出了可用于配置Imagine样式的值
Imagine
:
Variable Description Path
指定包含Imagine样式资产的目录的路径。如果未指定,则使用内置资产。
例如,要指定存储在资源系统中的目录的路径:
[Imagine] Path=:/imagine-assets
要指定本地目录的相对路径:
[Imagine] Path=imagine-assets
注意:由于技术限制,如果路径相对于文件,则不应将其命名为“ imagine”
qtquickcontrols2.conf
。
Material Section
- 下表在配置文件的一部分中列出了可用于配置Material style值
Material
:
Theme
指定默认的Material主题。该值可以是可用主题之一,例如 "Dark"
。Variant
指定材料变体。材质设计有两个变体:为触摸设备设计的普通变体和为台式机设计的密集变体。密集变体对控件及其字体使用较小的尺寸。
该值可以是
"Normal"
或"Dense"
。Accent
指定默认的“材质”强调颜色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一 "Teal"
。Primary
指定默认的Material原色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一 "BlueGrey"
。Foreground
指定默认的“材质前景色”。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一 "Brown"
。Background
指定默认的“材质”背景色。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一 "Grey"
。
Universal Section
- 下表在配置文件的一部分中列出了可用于配置Universal style值
Universal
:
Theme
指定默认的通用主题。该值可以是可用主题之一,例如 "Dark"
。Accent
指定默认的通用强调颜色。该值可以是任何颜色,但是建议使用例如预定义的通用颜色之一 "Violet"
。Foreground
指定默认的Universal前景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一 "Brown"
。Background
指定默认的通用背景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一 "Steel"
。
Font Configuration
- 可以在配置文件中每个样式部分的子组中指定默认字体
Font
。Font
可以通过两种替代方式定义该子组:[Default] Font\Family=Open Sans Font\PixelSize=20 [Material\Font] Family=Open Sans PixelSize=20
- 支持的字体属性:
Family
该字体系列。 PointSize
该点的大小。 PixelSize
在像素尺寸。 StyleHint
该风格的提示。可用值: SansSerif
,Helvetica
,Serif
,Times
,TypeWriter
,Courier
,OldEnglish
,Decorative
,Monospace
,Fantasy
,Cursive
。Weight
该重量。Qt使用从 0
到的加权比例,99
与Windows或CSS中使用的比例相似但不相同。的重量0
会很薄,而99
黑色则会非常重。可用的预定义权重:Thin
(0),ExtraLight
(12),Light
(25),Normal
(50),Medium
(57),DemiBold
(63),Bold
(75),ExtraBold
(81),Black
(87)。Style
风格。可用值: StyleNormal
,StyleItalic
,StyleOblique
。
Palette Configuration
- 可以在配置文件中每个样式部分的子组中指定默认调色板
Palette
。Palette
可以通过两种替代方式定义该子组:[Fusion] Palette\Window=#dedede Palette\WindowText=#212121
- 或者:
[Fusion\Palette] Window=#dedede WindowText=#212121
- 有关支持的属性的完整列表,请参见调色板QML基本类型。
在项目中使用配置文件
- 为了使Qt Quick Controls能够找到配置文件,必须使用The Qt Resource System将其内置到应用程序的资源中。这是一个示例
.qrc
文件:<!DOCTYPE RCC><RCC version="1.0"> <qresource prefix="/"> <file>qtquickcontrols2.conf</file> </qresource> </RCC>
- 注意: Qt Quick Controls使用文件选择器来加载配置文件。可以为不同的平台和语言环境提供不同的配置文件。有关更多详细信息,请参见QFileSelector文档。
- 最后,
.qrc
必须在应用程序的.pro
文件中列出该文件,以便构建系统知道该文件。例如:RESOURCES = application.qrc