Конфигурационный файл Qt Quick Controls

Qt Quick Controls 2 поддерживает специальный конфигурационный файл, :/qtquickcontrols2.conf, который встроен в ресурсы приложения.

Конфигурационный файл может задавать предпочтительный стиль и определённые атрибуты, связанные со стилем. В следующем примере указано, что предпочтительный стиль — материал. Кроме того, при запуске приложения со стилем Материал, его тема — светлая, а цвета акцента и основного фона — бирюзовый и тёмно-серый соответственно. Однако, если приложение запускается со стилем Универсальный, цвет акцента — красный, а соответствующая тема выбирается на основе цветов темы системы.

[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 Примечание: Из-за технического ограничения путь не должен называться "imagine", если он относительный по отношению к файлу `qtquickcontrols2.conf`.

Path

Указывает путь к каталогу, содержащему ресурсы стиля Imagine. Если не указано, используются встроенные ресурсы.

Например, чтобы указать путь к каталогу, хранящемуся в системе ресурсов:

[Imagine]
Path=:/imagine-assets

Чтобы указать относительный путь к локальному каталогу:

[Imagine]
Path=imagine-assets

Примечание: Из-за технического ограничения путь не должен называться "imagine", если он относительный по отношению к файлу qtquickcontrols2.conf.

Раздел Material

В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля Material в разделе Material конфигурационного файла:

Переменная	Описание
`Theme`	Задает тему Material по умолчанию. Значение может быть одной из доступных тем, например `"Dark"`.
`Variant`	Указывает вариант Material. Material Design имеет два варианта: обычный, предназначенный для сенсорных устройств, и плотный, для настольных систем. Плотный вариант использует меньшие размеры элементов управления и их шрифтов. Значение может быть `"Normal"` или `"Dense"`.
`Accent`	Указывает цвет акцента Material по умолчанию. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Material, например `"Teal"`.
`Primary`	Указывает основной цвет Material по умолчанию. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Material, например `"BlueGrey"`.
`Foreground`	Указывает цвет переднего плана Material по умолчанию. Значение может быть любым цветом или одним из предварительно определённых цветов Material, например `"Brown"`.
`Background`	Указывает цвет фона Material по умолчанию. Значение может быть любым цветом или одним из предварительно определённых цветов Material, например `"Grey"`.

Раздел Universal

В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля Универсальный в разделе Universal конфигурационного файла:

Переменная	Описание
`Theme`	Указывает тему Universal по умолчанию. Значение может быть одной из доступных тем, например `"Dark"`.
`Accent`	Указывает цвет акцента Universal по умолчанию. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Universal, например `"Violet"`.
`Foreground`	Указывает цвет переднего плана Universal по умолчанию. Значение может быть любым цветом или одним из предварительно определённых цветов Universal, например `"Brown"`.
`Background`	Указывает цвет фона Universal по умолчанию. Значение может быть любым цветом или одним из предварительно определённых цветов Universal, например `"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 palette для полного списка поддерживаемых атрибутов.

Использование конфигурационного файла в проекте

Чтобы Qt Quick Controls 2 смог найти конфигурационный файл, он должен быть встроен в ресурсы приложения с помощью системы ресурсов Qt. Вот пример .qrc файла:

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

Примечание: Qt Quick Controls 2 использует селектор файлов для загрузки конфигурационного файла. Можно предоставить разные конфигурационные файлы для разных платформ и языков. Подробнее см. документацию QFileSelector.

Наконец, файл .qrc должен быть указан в файле .pro приложения, чтобы система сборки знала о нём. Например:

RESOURCES = application.qrc

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qtquickcontrols2-configuration.html