Конфигурационный файл 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.

Раздел «Управление»

Следующие значения могут быть указаны в разделе Controls конфигурационного файла:

Переменная	Описание
`Style`	Указывает стиль, с которым будет запущено приложение. Значение может быть именем одного из встроенных стилей или пользовательским стилем.
`FallbackStyle`	Указывает стиль, используемый для элементов управления, которые не реализованы. Стиль должен быть одним из встроенных стилей. По умолчанию используется стиль По умолчанию.

Раздел «Представить»

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

Переменная Описание

Переменная	Описание
`Path`	Указывает путь к каталогу, содержащему ресурсы стиля «Представить». Если не указано, используются встроенные ресурсы. Например, чтобы указать путь к каталогу, хранящемуся в системе ресурсов: [Imagine] Path=:/imagine-assets Чтобы указать относительный путь к локальному каталогу: [Imagine] Path=imagine-assets Примечание: Из-за технического ограничения путь не должен называться «imagine», если он относительный к файлу `qtquickcontrols2.conf`.

Path

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

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

[Imagine]
Path=:/imagine-assets

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

[Imagine]
Path=imagine-assets

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

Раздел «Материальный»

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

Переменная	Описание
`Theme`	Указывает стандартную тему Материального стиля. Значение может быть одним из доступных тем, например `"Dark"`.
`Variant`	Указывает вариант Материального дизайна. Материальный дизайн имеет два варианта: обычный, предназначенный для сенсорных устройств, и плотный, для настольных компьютеров. Плотный вариант использует меньшие размеры для элементов управления и их шрифтов. Значение может быть `"Normal"` или `"Dense"`.
`Accent`	Указывает стандартный цвет акцента Материального стиля. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определенных цветов Материального, например `"Teal"`.
`Primary`	Указывает стандартный основной цвет Материального стиля. Значение может быть любым цветом, но рекомендуется использовать один из предварительно определенных цветов Материального, например `"BlueGrey"`.
`Foreground`	Указывает стандартный цвет переднего плана Материального стиля. Значение может быть любым цветом или одним из предварительно определенных цветов Материального, например `"Brown"`.
`Background`	Указывает стандартный цвет фона Материального стиля. Значение может быть любым цветом или одним из предварительно определенных цветов Материального, например `"Grey"`.

Раздел «Универсальный»

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

Переменная	Описание
`Theme`	Указывает тему по умолчанию Universal. Значение может быть одной из доступных тем, например `"Dark"`.
`Accent`	Указывает цвет акцента по умолчанию Universal. Значение может быть любым цветом, но рекомендуется использовать один из предопределённых цветов Universal, например `"Violet"`.
`Foreground`	Указывает цвет фона по умолчанию Universal. Значение может быть любым цветом или одним из предопределённых цветов Universal, например `"Brown"`.
`Background`	Указывает цвет фона по умолчанию Universal. Значение может быть любым цветом или одним из предопределённых цветов Universal, например `"Steel"`.

Настройка шрифтов

Шрифт по умолчанию font может быть указан в подгруппе 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 в каждом разделе стиля в файле конфигурации. Подгруппа 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.14/qtquickcontrols2-configuration.html