Файл конфигурации Qt Quick Controls
Qt Quick Controls поддерживает специальный файл конфигурации, qtquickcontrols2.conf, который встроен в ресурсы приложения.
Файл конфигурации может задавать предпочтительный стиль и определенные атрибуты, специфичные для стиля. В следующем примере задается предпочтительный стиль Материальный стиль. Кроме того, при запуске приложения с Материальным стилем, его темой является светлая, а цвета акцента и первичного цвета соответственно — изумрудно-бирюзовый и сизо-серый. Однако, если приложение запускается с Универсальным стилем, цвет акцента красный, а соответствующая тема выбирается на основе цветовой темы системы.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
Можно указать пользовательское расположение файла конфигурации с помощью переменной среды QT_QUICK_CONTROLS_CONF.
Раздел элементов управления
В следующем разделе файла конфигурации можно указать следующие значения:
| Переменная | Описание |
|---|---|
Style |
Задает стиль, с которым будет запущено приложение. Значение может быть именем одного из встроенных стилей или пользовательского стиля. |
FallbackStyle |
Задает стиль для элементов управления, которые не реализованы. Стиль должен быть одним из встроенных стилей. По умолчанию используется стиль По умолчанию. |
Раздел Imagine
В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля Imagine в разделе Imagine файла конфигурации:
| Переменная | Описание |
|---|---|
Path |
Указывает путь к каталогу, содержащему активы стиля Imagine. Если не указано, используются встроенные активы. Например, для указания пути к каталогу, хранящемуся в системе ресурсов: [Imagine] Path=:/imagine-assets Для указания относительного пути к локальному каталогу: [Imagine] Path=imagine-assets Примечание: Из-за технического ограничения путь не должен быть назван "imagine", если он является относительным к файлу |
Раздел Material
В следующей таблице перечислены значения, которые могут быть использованы для настройки Материального стиля в разделе Material файла конфигурации:
| Переменная | Описание |
|---|---|
Theme |
Задает стандартную тему Material. Значение может быть одной из доступных тем, например "Dark". |
Variant |
Задает вариант Material. В Material Design есть два варианта: обычный, предназначенный для сенсорных устройств, и плотный, для настольных компьютеров. Плотный вариант использует меньшие размеры для элементов управления и их шрифтов. Значение может быть |
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 палитры для полного списка поддерживаемых атрибутов.
Использование файла конфигурации в проекте
Для того, чтобы Qt Quick Controls мог найти файл конфигурации, он должен быть встроен в ресурсы приложения с помощью Системы ресурсов Qt. Вот пример .qrc файла:
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
<file>qtquickcontrols2.conf</file>
</qresource>
</RCC> Примечание: Qt Quick Controls использует селектор файлов для загрузки файла конфигурации. Можно предоставить разные файлы конфигурации для разных платформ и языков. Подробнее см. документацию 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.15/qtquickcontrols2-configuration.html
