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 |
Указывает стиль, который будет использоваться для элементов управления, которые не реализованы. Стиль должен быть одним из встроенных стилей. По умолчанию используется стиль по умолчанию. |
Раздел «Воображение»
В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля «Воображение» в разделе Imagine файла конфигурации:
| Переменная | Описание |
|---|---|
Path |
Указывает путь к каталогу, содержащему ресурсы стиля «Воображение». Если не указано, используются встроенные ресурсы. Например, чтобы указать путь к каталогу, хранящемуся в системе ресурсов: [Imagine] Path=:/imagine-assets Чтобы указать относительный путь к локальному каталогу: [Imagine] Path=imagine-assets Примечание: Из-за технического ограничения, путь не должен быть назван «imagine», если он является относительным к файлу |
Раздел «Материал»
В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля «Материал» в разделе Material файла конфигурации:
| Переменная | Описание |
|---|---|
Theme |
Указывает стандартную тему «Материал». Значение может быть одной из доступных тем, например "Dark". |
Accent |
Указывает стандартный цвет акцента «Материал». Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов «Материал», например "Teal". |
Primary |
Указывает стандартный первичный цвет «Материал». Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов «Материал», например "BlueGrey". |
Foreground |
Указывает стандартный цвет переднего плана «Материал». Значение может быть любым цветом или одним из предварительно определённых цветов «Материал», например "Brown". |
Background |
Указывает стандартный цвет фона «Материал». Значение может быть любым цветом или одним из предварительно определённых цветов «Материал», например "Grey". |
Раздел «Универсальный»
В следующей таблице перечислены значения, которые могут быть использованы для настройки стиля «Универсальный» в разделе Universal файла конфигурации:
| Переменная | Описание |
|---|---|
Theme |
Указывает стандартную тему «Универсальный». Значение может быть одной из доступных тем, например "Dark". |
Accent |
Указывает стандартный цвет акцента «Универсальный». Значение может быть любым цветом, но рекомендуется использовать один из предварительно определённых цветов «Универсальный», например "Violet". |
Foreground |
Указывает стандартный цвет переднего плана «Универсальный». Значение может быть любым цветом или одним из предварительно определённых цветов «Универсальный», например "Brown". |
Background |
Указывает стандартный цвет фона «Универсальный». Значение может быть любым цветом или одним из предварительно определённых цветов «Универсальный», например "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 Basic Type для полного списка поддерживаемых атрибутов.
Использование файла конфигурации в проекте
Для того, чтобы 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/archives/qt-5.11/qtquickcontrols2-configuration.html
