Стилизация Qt Quick Controls 2

Доступные стили

Qt Quick Controls 2 поставляется с набором стилей.

Стиль по умолчанию

Стиль по умолчанию — простой и лёгкий универсальный стиль, обеспечивающий максимальную производительность для Qt Quick Controls 2.

Стиль Fusion

Стиль Fusion — платформенно-независимый стиль, предлагающий вид и ощущения настольного приложения для Qt Quick Controls 2.

Стиль Imagine

Стиль Imagine основан на изображениях. Стиль поставляется с набором изображений, которые можно легко изменить, указав директорию с изображениями, используя предопределённую систему именования.

Стиль Material

Стиль Material предлагает привлекательный дизайн, основанный на Руководстве по дизайну Google Material, но требует больше системных ресурсов, чем стиль по умолчанию.

Стиль Universal

Стиль Universal предлагает привлекательный дизайн, основанный на Руководстве по универсальному дизайну Microsoft, но требует больше системных ресурсов, чем стиль по умолчанию.

Использование стилей в Qt Quick Controls 2

Для запуска приложения с определённым стилем можно настроить стиль с помощью QQuickStyle в C++, передать аргумент командной строки или установить переменную окружения. Также предпочтительный стиль и атрибуты, специфичные для стиля, можно указать в конфигурационном файле.

Приоритет этих подходов соответствует порядку их перечисления, от наивысшего к наименьшему. То есть, использование QQuickStyle для установки стиля всегда будет иметь приоритет по сравнению с использованием аргумента командной строки, например.

Использование QQuickStyle в C++

QQuickStyle предоставляет API C++ для настройки определённого стиля. Следующий пример запускает приложение Qt Quick Controls 2 со стилем Material:

QQuickStyle::setStyle("Material");

Для получения более подробной информации см. подробное описание QQuickStyle.

Аргумент командной строки

Передача аргумента -style командной строки — удобный способ тестирования различных стилей. Он имеет приоритет над другими методами, перечисленными ниже. Следующий пример запускает приложение Qt Quick Controls 2 со стилем Material:

./app -style material

Переменная окружения

Установка переменной окружения QT_QUICK_CONTROLS_STYLE может использоваться для установки глобальных настроек стиля. Она имеет приоритет над конфигурационным файлом, упомянутым ниже. Следующий пример запускает приложение Qt Quick Controls 2 со стилем Universal:

QT_QUICK_CONTROLS_STYLE=universal ./app

Полный список поддерживаемых переменных окружения см. в Поддерживаемые переменные окружения в Qt Quick Controls 2.

Конфигурационный файл

Qt Quick Controls 2 поддерживает специальный конфигурационный файл, :/qtquickcontrols2.conf, который встроен в ресурсы приложения.

Конфигурационный файл может указать предпочтительный стиль (который может быть переопределён любым из описанных выше методов) и определённые атрибуты, специфичные для стиля. Следующий пример указывает, что предпочтительным стилем является стиль Material.

[Controls]
Style=Material

Дополнительную информацию о конфигурационном файле см. в Конфигурационный файл Qt Quick Controls 2.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtquickcontrols2-styles.html