Конфигурационный файл 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", если он является относительным к файлу `qtquickcontrols2.conf`.

Path

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

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

[Imagine]
Path=:/imagine-assets

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

[Imagine]
Path=imagine-assets

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

Раздел Material

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

Переменная	Описание
`Theme`	Указывает значение темы Material по умолчанию. Значение может быть одной из доступных тем, например `"Dark"`.
`Variant`	Указывает вариант Material. Материал Design имеет два варианта: нормальный, предназначенный для сенсорных устройств, и плотный — для настольных компьютеров. Плотный вариант использует меньшие размеры элементов управления и их шрифтов. Значение может быть `"Normal"` или `"Dense"`.
`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 может быть определена двумя альтернативными способами:

[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121

или:

[Fusion\Palette]
Window=#dedede
WindowText=#212121

Для получения дополнительной информации см. тип QML Palette.

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

Чтобы 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.0/qtquickcontrols2-configuration.html