Стилизация 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