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

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

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

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

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

Стиль Fusion

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

Стиль Imagine

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

Стиль Material

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

Стиль 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/archives/qt-5.11/qtquickcontrols2-styles.html