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 环境变量指定配置文件的自定义位置。
控件部分#
可以在配置文件的 Controls 部分指定以下值
想象部分#
以下表格列出了可用于在配置文件的 Imagine 部分中配置 Imagine 样式 的值
变量
描述
路径指定包含 Imagine 样式资源的目录的 路径。如果没有指定，则使用内置资源。
例如，要指定存储在资源系统中的目录的路径
[Imagine] Path=:/imagine-assets要指定到本地目录的相对路径
[Imagine] Path=imagine-assets注意
由于技术限制，如果路径相对于
qtquickcontrols2.conf文件，则路径不应命名为“imagine”。
材质部分#
以下表格列出了可用于在配置文件的 Material 部分中配置 Material 样式 的值
变量
描述
主题指定默认的Material主题。值可以是可用的任何主题，例如
"Dark"。
变体指定Material变体。Material设计有两种变体：为触摸设备设计的普通变体，以及用于桌面的密集变体。密集变体使用控制和它们的字体较小的大小。
值可以是
"Normal"或"Dense"。
强调色指定默认的Material强调色。值可以是任何颜色，但建议使用预定义的其中一种Material颜色，例如
"Teal"。
主色指定默认的Material主色。值可以是任何颜色，但建议使用预定义的其中一种Material颜色，例如
"BlueGrey"。
前景色指定默认的Material前景色。值可以是任何颜色，或者是预定义的其中一种Material颜色，例如
"Brown"。
背景色指定默认的Material背景色。值可以是任何颜色，或者是预定义的其中一种Material颜色，例如
"Grey"。
通用部分#
以下表格列出了可配置配置文件中Universal部分中通用样式的值
字体配置#
默认字体可以在配置文件的每个样式的部分中的 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使用与OpenType兼容的从
1到1000的加权缩放。值为1将是细的，而值为1000将是非常深的。可用的预定义粗细：Thin（100）、ExtraLight（200）、Light（300）、Normal（400）、Medium（500）、DemiBold（600）、Bold（700）、ExtraBold（800）、Black（900）。
样式Style
样式。可用值：StyleNormal、StyleItalic、StyleOblique。
调色板配置#
[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 文件。例如
使用 CMake#
set(CMAKE_AUTORCC ON) qt_add_executable(my_app application.qrc main.cpp ... )
使用 qmake#
RESOURCES = application.qrc ...
另请参阅：构建系统集成