Qt - Quick控件配置文件(qtquickcontrols
Qt Quick控件配置文件
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
在配置文件的一部分中指定以下值:
变量 | 描述 |
---|---|
Style |
指定运行应用程序的样式。该值可以是内置样式或自定义样式之一的名称。 |
FallbackStyle |
指定用于未实现的控件的样式。样式必须是内置样式之一。默认情况下,使用默认样式。 |
Imagine部分
下表在配置文件的一部分中列出了可用于配置Imagine样式的值Imagine
:
变量 | 描述 |
---|---|
Path |
指定包含Imagine样式资产的目录的路径。如果未指定,则使用内置资产。 |
例如,要指定存储在资源系统的目录的路径:
[Imagine]
Path=:/imagine-assets
要指定本地目录的相对路径:
[Imagine]
Path=imagine-assets
注意:由于技术限制,如果路径相对于文件qtquickcontrols2.conf
,则不应将其命名为“ imagine”。
Material部分
下表在配置文件的一部分中列出了可用于配置材料样式的值Material
:
变量 | 描述 |
---|---|
Theme |
指定默认的Material主题。该值可以是可用主题之一,例如"Dark" 。 |
Variant |
指定材料变体。材质设计有两个变体:为触摸设备设计的普通变体和为桌面设计的密集变体。密集变体为控件及其字体使用较小的尺寸。该值可以是"Normal" 或"Dense" 。 |
Accent |
指定默认的“ 材质”强调颜色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一"Teal" 。 |
Primary |
指定默认的Material原色。该值可以是任何颜色,但是建议使用例如预定义的“材质”颜色之一"BlueGrey" 。 |
Foreground |
指定默认的Material前景颜色。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一"Brown" 。 |
Background |
指定默认的“ 材质”背景色。例如,该值可以是任何颜色,也可以是预定义的“材质”颜色之一"Grey" 。 |
Universal部分
下表在配置文件的一部分中列出了可用于配置通用样式的值Universal
:
变量 | 描述 |
---|---|
Theme |
指定默认的通用主题。该值可以是可用主题之一,例如"Dark" 。 |
Accent |
指定默认的通用强调颜色。该值可以是任何颜色,但是建议使用例如预定义的通用颜色之一"Violet" 。 |
Foreground |
指定默认的Universal前景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一"Brown" 。 |
Background |
指定默认的通用背景色。例如,该值可以是任何颜色,也可以是预定义的通用颜色之一"Steel" 。 |
字体配置
可以在配置文件中每个样式部分的子组中指定默认字体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
。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