Qt Quick Controls 配置文件_在运行时选择样式,在程序中必须导人qtquick.control-CSDN博客

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。

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

`Style`	指定运行应用程序的样式。该值可以是内置样式或自定义样式之一的名称。
`FallbackStyle`	指定用于未实现的控件的样式。样式必须是内置样式之一。默认情况下，使用默认样式。

`Theme`	指定默认的Material主题。该值可以是可用主题之一，例如`"Dark"`。
`Variant`	指定材料变体。材质设计有两个变体：为触摸设备设计的普通变体和为台式机设计的密集变体。密集变体对控件及其字体使用较小的尺寸。该值可以是`"Normal"`或`"Dense"`。
`Accent`	指定默认的“材质”强调颜色。该值可以是任何颜色，但是建议使用例如预定义的“材质”颜色之一`"Teal"`。
`Primary`	指定默认的Material原色。该值可以是任何颜色，但是建议使用例如预定义的“材质”颜色之一`"BlueGrey"`。
`Foreground`	指定默认的“材质前景色”。例如，该值可以是任何颜色，也可以是预定义的“材质”颜色之一`"Brown"`。
`Background`	指定默认的“材质”背景色。例如，该值可以是任何颜色，也可以是预定义的“材质”颜色之一`"Grey"`。

`Theme`	指定默认的通用主题。该值可以是可用主题之一，例如`"Dark"`。
`Accent`	指定默认的通用强调颜色。该值可以是任何颜色，但是建议使用例如预定义的通用颜色之一`"Violet"`。
`Foreground`	指定默认的Universal前景色。例如，该值可以是任何颜色，也可以是预定义的通用颜色之一`"Brown"`。
`Background`	指定默认的通用背景色。例如，该值可以是任何颜色，也可以是预定义的通用颜色之一`"Steel"`。

`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`。