Qt Quick控件配置文件
Qt Quick Controls支持一個(gè)特殊的配置文件qtquickcontrols2.conf催烘，該文件內(nèi)置于應(yīng)用程序的資源中。
配置文件可以指定首選樣式和某些樣式特定的屬性泣崩。下面的示例指定首選樣式為Material樣式。此外洛口，當(dāng)應(yīng)用程序以“材質(zhì)”樣式運(yùn)行時(shí)矫付，其主題為淺色，強(qiáng)調(diào)色和原色分別為藍(lán)綠色和藍(lán)灰色第焰。但是买优，如果應(yīng)用程序改用通用樣式運(yùn)行，則強(qiáng)調(diào)色為紅色樟遣，并根據(jù)系統(tǒng)主題色選擇適當(dāng)?shù)闹黝}而叼。
[Controls]
Style=Material
[Universal]
Theme=System
Accent=Red
[Material]
Theme=Light
Accent=Teal
Primary=BlueGrey
可以使用QT_QUICK_CONTROLS_CONF環(huán)境變量為配置文件指定自定義位置。
控制部分
可以Controls在配置文件的一部分中指定以下值：
| 變量 | 描述 |
|---|---|
Style |
指定運(yùn)行應(yīng)用程序的樣式豹悬。該值可以是內(nèi)置樣式或自定義樣式之一的名稱葵陵。 |
FallbackStyle |
指定用于未實(shí)現(xiàn)的控件的樣式。樣式必須是內(nèi)置樣式之一瞻佛。默認(rèn)情況下脱篙，使用默認(rèn)樣式。 |
Imagine部分
下表在配置文件的一部分中列出了可用于配置Imagine樣式的值Imagine：
| 變量 | 描述 |
|---|---|
Path |
指定包含Imagine樣式資產(chǎn)的目錄的路徑伤柄。如果未指定绊困，則使用內(nèi)置資產(chǎn)。 |
例如适刀，要指定存儲(chǔ)在資源系統(tǒng)的目錄的路徑：
[Imagine]
Path=:/imagine-assets
要指定本地目錄的相對路徑：
[Imagine]
Path=imagine-assets
注意：由于技術(shù)限制秤朗，如果路徑相對于文件qtquickcontrols2.conf，則不應(yīng)將其命名為“ imagine”笔喉。
Material部分
下表在配置文件的一部分中列出了可用于配置材料樣式的值Material：
| 變量 | 描述 |
|---|---|
Theme |
指定默認(rèn)的Material主題取视。該值可以是可用主題之一硝皂，例如"Dark"。 |
Variant |
指定材料變體作谭。材質(zhì)設(shè)計(jì)有兩個(gè)變體：為觸摸設(shè)備設(shè)計(jì)的普通變體和為桌面設(shè)計(jì)的密集變體稽物。密集變體為控件及其字體使用較小的尺寸。該值可以是"Normal"或"Dense"折欠。 |
Accent |
指定默認(rèn)的“ 材質(zhì)”強(qiáng)調(diào)顏色贝或。該值可以是任何顏色，但是建議使用例如預(yù)定義的“材質(zhì)”顏色之一"Teal"锐秦。 |
Primary |
指定默認(rèn)的Material原色咪奖。該值可以是任何顏色，但是建議使用例如預(yù)定義的“材質(zhì)”顏色之一"BlueGrey"酱床。 |
Foreground |
指定默認(rèn)的Material前景顏色赡艰。例如，該值可以是任何顏色斤葱，也可以是預(yù)定義的“材質(zhì)”顏色之一"Brown"。 |
Background |
指定默認(rèn)的“ 材質(zhì)”背景色揖闸。例如揍堕，該值可以是任何顏色，也可以是預(yù)定義的“材質(zhì)”顏色之一"Grey"汤纸。 |
Universal部分
下表在配置文件的一部分中列出了可用于配置通用樣式的值Universal：
| 變量 | 描述 |
|---|---|
Theme |
指定默認(rèn)的通用主題衩茸。該值可以是可用主題之一，例如"Dark"贮泞。 |
Accent |
指定默認(rèn)的通用強(qiáng)調(diào)顏色楞慈。該值可以是任何顏色，但是建議使用例如預(yù)定義的通用顏色之一"Violet"啃擦。 |
Foreground |
指定默認(rèn)的Universal前景色囊蓝。例如，該值可以是任何顏色令蛉，也可以是預(yù)定義的通用顏色之一"Brown"聚霜。 |
Background |
指定默認(rèn)的通用背景色。例如珠叔，該值可以是任何顏色蝎宇，也可以是預(yù)定義的通用顏色之一"Steel"。 |
字體配置
可以在配置文件中每個(gè)樣式部分的子組中指定默認(rèn)字體Font祷安。Font可以通過兩種替代方式定義該子組：
[Default]
Font\Family=Open Sans
Font\PixelSize=20
[Material\Font]
Family=Open Sans
PixelSize=20
支持的字體屬性：
| 變量 | 描述 |
|---|---|
Family |
該字體系列姥芥。 |
PointSize |
該點(diǎn)的大小。 |
PixelSize |
在像素尺寸汇鞭。 |
StyleHint |
該風(fēng)格的提示凉唐∮棺罚可用值：SansSerif，Helvetica熊榛，Serif锚国，Times，TypeWriter玄坦，Courier血筑，OldEnglish，Decorative煎楣，Monospace豺总，Fantasy，Cursive择懂。 |
Weight |
該重量喻喳。Qt使用從0到的加權(quán)比例，99與Windows或CSS中使用的比例相似但不相同困曙。的重量0會(huì)很薄表伦，而99黑色則會(huì)很重】独觯可用的預(yù)定義權(quán)重：Thin（0）蹦哼，ExtraLight（12），Light（25）要糊，Normal（50）纲熏，Medium（57），DemiBold（63）锄俄，Bold（75）局劲，ExtraBold（81），Black（87）奶赠。 |
Style |
風(fēng)格鱼填。可用值：StyleNormal毅戈，StyleItalic剔氏，StyleOblique。 |
面板配置
可以在配置文件中每個(gè)樣式部分的子組中指定默認(rèn)調(diào)色板Palette竹祷。Palette可以通過兩種替代方式定義該子組：
[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121
要么：
[Fusion\Palette]
Window=#dedede
WindowText=#212121
有關(guān)支持的屬性的完整列表谈跛，請參見調(diào)色板QML基本類型。
在項(xiàng)目中使用配置文件
為了使Qt Quick Controls可以找到配置文件塑陵，必須使用The Qt Resource System將其內(nèi)置到應(yīng)用程序的資源中感憾。這是一個(gè)示例.qrc文件：
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
<file>qtquickcontrols2.conf</file>
</qresource>
</RCC>
注意： Qt Quick Controls使用文件選擇器來加載配置文件。可以為不同的平臺(tái)和語言環(huán)境提供不同的配置文件阻桅。有關(guān)更多詳細(xì)信息凉倚，請參見QFileSelector文檔。
最后嫂沉，.qrc必須在應(yīng)用程序的.pro文件中列出該文件稽寒，以便構(gòu)建系統(tǒng)知道該文件。例如：
RESOURCES = application.qrc
