Конфигурационный файл Qt Quick Controls
Qt Quick Controls поддерживает специальный конфигурационный файл, qtquickcontrols2.conf, который встроен в ресурсы приложения.
Конфигурационный файл может указывать предпочтительный стиль и определённые атрибуты, специфичные для стиля. Следующий пример указывает, что предпочтительный стиль — стиль Material. Кроме того, при запуске приложения со стилем Material тема установлена в светлую, а акцентный и основной цвета — изумрудно-зелёный и сине-серый соответственно. Однако, если приложение запускается со стилем Universal, акцентный цвет красный, а соответствующая тема выбирается на основе цветовой темы системы.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
Можно указать пользовательское расположение конфигурационного файла с помощью переменной среды QT_QUICK_CONTROLS_CONF.
Раздел Controls
Следующие значения могут быть указаны в разделе Controls конфигурационного файла:
| Переменная | Описание |
|---|---|
Style |
Указывает стиль, с которым запускается приложение. Значение может быть именем одного из встроенных стилей или пользовательского стиля. |
FallbackStyle |
Указывает стиль, используемый для элементов управления, которые не реализованы. Стиль должен быть одним из встроенных стилей. По умолчанию используется стиль Basic. |
Раздел Imagine
В следующей таблице перечислены значения, которые могут использоваться для настройки стиля Imagine в разделе Imagine конфигурационного файла:
| Переменная | Описание |
|---|---|
Path |
Указывает путь к каталогу, содержащему ресурсы стиля Imagine. Если не указано, используются встроенные ресурсы. Например, чтобы указать путь к каталогу, хранящемуся в системе ресурсов: [Imagine] Path=:/imagine-assets Чтобы указать относительный путь к локальному каталогу: [Imagine] Path=imagine-assets Примечание: Из-за технических ограничений путь не должен называться "imagine", если он относительный к файлу |
Раздел Material
В следующей таблице перечислены значения, которые могут использоваться для настройки стиля 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 в разделе Universal конфигурационного файла:
| Переменная | Описание |
|---|---|
Theme |
Указывает стандартную тему Universal. Значение может быть одной из доступных тем, например "Dark". |
Accent |
Указывает стандартный акцентный цвет Universal. Значение может быть любым цветом, но рекомендуется использовать один из предопределённых цветов Universal, например "Violet". |
Foreground |
Указывает стандартный цвет переднего плана Universal. Значение может быть любым цветом или одним из предопределённых цветов Universal, например "Brown". |
Background |
Указывает стандартный цвет фона Universal. Значение может быть любым цветом или одним из предопределённых цветов Universal, например "Steel". |
Настройка шрифта
Стандартный шрифт может быть указан в подгруппе Font в каждом разделе стиля в конфигурационном файле. Подгруппа Font может быть определена двумя альтернативными способами:
[Basic] 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 использует шкалу весов от 1 до 1000, совместимую с OpenType. Вес 1 будет тонким, а 1000 — очень жирным. Доступные предопределённые веса: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style |
Стиль шрифта. Доступные значения: StyleNormal, StyleItalic, StyleOblique. |
Настройка палитры
Стандартную palette можно настроить для каждого стиля, используя подгруппу Palette в конфигурационном файле. Подгруппа Palette может быть определена двумя альтернативными способами:
[Fusion] Palette\Window=#dedede Palette\WindowText=#212121
или:
[Fusion\Palette] Window=#dedede WindowText=#212121
См. тип Palette 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-6.2/qtquickcontrols2-configuration.html
