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

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

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

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

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

Стиль Fusion

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

Стиль Imagine

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

Стиль Material

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

Стиль Universal

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

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

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

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

Предупреждение: При разрешении имени стиля до абсолютного пути, QQuickStyle может искать в корневом каталоге ресурсов (:). Следовательно, убедитесь, что ваши каталоги ресурсов имеют имена, отличные от имён стилей, поддерживаемых вашим приложением. В противном случае стили могут не загрузиться. Например, избегайте именования каталога ресурсов :/material (или :/Material) если приложение поддерживает стиль Material.

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

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

QQuickStyle::setStyle("Material");

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

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

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

./app -style material

Переменная среды

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

QT_QUICK_CONTROLS_STYLE=universal ./app

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

Файл конфигурации

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

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

[Controls]
Style=Material

См. Файл конфигурации Qt Quick Controls для получения дополнительной информации о файле конфигурации.

Дополнительная информация

• Стиль по умолчанию
• Стиль Fusion
• Стиль Imagine
• Стиль Material
• Стиль Universal
• Настройка Qt Quick Controls
• Использование диалогов выбора файлов с Qt Quick Controls
• Развёртывание приложений Qt Quick Controls
• Файл конфигурации Qt Quick Controls
• Поддерживаемые переменные среды в Qt Quick Controls