Файл конфигурации Qt Quick Controls 2
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 |
Указывает стиль, который использовать для элементов управления, которые не реализованы. Стиль должен быть одним из встроенных стилей. По умолчанию используется стиль По умолчанию. |
Раздел "Материал"
Следующие значения, специфичные для Материального стиля, можно указать в разделе Material файла конфигурации:
| Переменная | Описание |
|---|---|
Theme |
Указывает стандартную тему Материального стиля. Значение может быть одной из доступных тем, например "Dark". |
Accent |
Указывает стандартный цвет акцента Материального стиля. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Материального стиля, например "Teal". |
Primary |
Указывает стандартный основной цвет Материального стиля. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Материального стиля, например "BlueGrey". |
Foreground |
Указывает стандартный цвет переднего плана Материального стиля. Значение может быть любым цветом или одним из предварительно определённых цветов Материального стиля, например "Brown". |
Background |
Указывает стандартный цвет фона Материального стиля. Значение может быть любым цветом или одним из предварительно определённых цветов Материального стиля, например "Grey". |
Раздел "Универсальный"
Следующие значения, специфичные для Универсального стиля, можно указать в разделе Universal файла конфигурации:
| Переменная | Описание |
|---|---|
Theme |
Указывает стандартную тему Универсального стиля. Значение может быть одной из доступных тем, например "Dark". |
Accent |
Указывает стандартный цвет акцента Универсального стиля. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов Универсального стиля, например "Violet". |
Foreground |
Указывает стандартный цвет переднего плана Универсального стиля. Значение может быть любым цветом или одним из предварительно определённых цветов Универсального стиля, например "Brown". |
Background |
Указывает стандартный цвет фона Универсального стиля. Значение может быть любым цветом или одним из предварительно определённых цветов Универсального стиля, например "Steel". |
Использование файла конфигурации в проекте
Для того, чтобы 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.9/qtquickcontrols2-configuration.html
