Qt Quick控件配置文件

Qt Quick控件支持一个特殊的配置文件，名为qtquickcontrols2.conf，它构建到应用程序的资源中。

配置文件可以指定首选风格和某些特定于风格的属性。以下示例指定首选风格是Material风格。此外，如果应用程序以Material风格运行，其主题为亮色，强调和主颜色分别为青色和蓝灰色。但是，如果以通用风格运行应用程序，强调颜色为红色，并基于系统主题颜色选择合适的主题。

[Controls]
Style=Material

[Universal]
Theme=System
Accent=Red

[Material]
Theme=Light
Accent=Teal
Primary=BlueGrey

可以使用QT_QUICK_CONTROLS_CONF环境变量指定配置文件的自定义位置。

控件节

配置文件中的控件节可以指定以下值

变量描述
风格指定要以何种风格运行应用程序。值可以是内置风格的名称之一或一个自定义风格。
回退风格指定没有实现的控制要使用的风格。该风格必须是内置风格之一。默认情况下，使用基本风格。

Imagine节

以下表格列出了可以在配置文件的Imagine节中使用的值以配置Imagine风格

变量描述
路径指定包含Imagine风格资源的目录的路径。如果未指定，使用内置资源。

例如，指定存储在资源系统中的目录的路径

[Imagine]
Path=:/imagine-assets

指定到本地目录的相对路径

[Imagine]
Path=imagine-assets

注意：由于技术限制，如果路径相对qtquickcontrols2.conf文件，则路径不应命名为"imagine"。

Material节

以下表格列出了可以在配置文件的Material节中使用的值以配置Material风格

变量描述
主题指定默认的Material主题。值可以是可用的主题之一，例如"Dark"。
变体指定Material变体。Material Design有两种变体：一种是为触摸设备设计的正常变体，另一种是密集变体，适用于桌面。密集变体使用较小的控件和字体大小。

值可以是 "正常" 或 "密集"。

强调色指定默认的 材质强调色。值可以是任何 颜色，但建议使用其中之一 预定义材质颜色，例如 "青色"。
主色指定默认的 材质主色。值可以是任何 颜色，建议使用其中之一 预定义材质颜色，例如 "蓝灰色"。
前景色指定默认的 材质前景色。值可以是任何 颜色，或其中之一 预定义材质颜色，例如 "棕色"。
背景色指定默认的 材质背景色。值可以是任何 颜色，或其中之一 预定义材质颜色，例如 "灰色"。

通用部分

下表列出了可以用于配置配置文件中 通用 部分的 通用样式 的值

变量描述
主题指定默认的 通用主题。值可以是可用的主题之一，例如 "暗色"。
强调色指定默认的 通用强调色。值可以是任何 颜色，但建议使用其中之一 预定义通用颜色，例如 "紫色"。
前景色指定默认的 通用前景色。值可以是任何 颜色，或其中之一 预定义通用颜色，例如 "棕色"。
背景色指定默认的 通用背景色。值可以是任何 颜色，或其中之一 预定义通用颜色，例如 "钢蓝"。

字体配置

默认 字体 可以在配置文件的每个样式的 Font 子组中指定

[Basic]
Font\Family=Open Sans
Font\PixelSize=20

支持的字体属性

变量描述
Family字体 家族。
PointSize点 大小。
PixelSize像素 大小。
StyleHint样式提示 提示。可用值： "SansSerif"，"Helvetica"，"Serif"，"Times"，"TypeWriter"，"Courier"，"OldEnglish"，"Decorative"，"Monospace"，"Fantasy"，"Cursive"。
Weight字重。Qt 使用从 1 到 1000 的 OpenType 兼容的权重标度。字重为 1 表示细体，而 1000 则表示非常黑。可用的预设字重：瘦体 (100), 超细体 (200), 细体 (300), 正常 (400), 中等 (500), 半粗体 (600), 粗体 (700), 超粗体 (800), 黑体 (900)。
风格样式。可用值：StyleNormal，StyleItalic，StyleOblique。

调色板配置

默认的 palette 可以使用配置文件中的 Palette 子组为每种样式进行配置。可以以两种替代方式定义 Palette 子组

[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121

有关更多信息，请参阅 Palette QML 类型。

在项目中使用配置文件

为了使 Qt Quick Controls 能够找到配置文件，必须使用 Qt 资源系统 将其构建到应用程序的资源中。以下是一个示例 .qrc 文件

<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
    <file>qtquickcontrols2.conf</file>
</qresource>
</RCC>

注意：Qt Quick Controls 使用文件选择器来加载配置文件。可以为不同的平台和区域提供不同的配置文件。有关更多信息，请参阅 QFileSelector 文档。

最后，必须在应用程序的构建文件中列出 .qrc 文件。例如

set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
    application.qrc
    main.cpp
    ...
)
RESOURCES = application.qrc
...

另请参阅：构建系统集成

© 2024 Qt 公司有限公司。本文件中包含的文档贡献的版权归其各自的拥有者。本文件提供的文档是根据自由软件基金会的规定，在 GNU 自由文档许可协议版本 1.3 的条款下授权的。Qt 及其相应的标志是芬兰的 Qt 公司和/或其他国家的注册商标。所有其他商标均为其各自所有者的财产。