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

Существует два способа использования стилей в Qt Quick Controls: выбор стиля во время выполнения и выбор стиля во время компиляции.

Выбор стиля во время компиляции

Выбор стиля во время компиляции включает использование импорта QML для указания стиля. Например, для импорта стиля Material:

import QtQuick.Controls.Material

ApplicationWindow {
    // ...
}

Обратите внимание, что QtQuick.Controls (который отвечает за выбор стиля во время выполнения) не импортируется. Стили по умолчанию определяются в qmldir файла стиля:

module QtQuick.Controls.Material
# ...
import QtQuick.Controls.Basic auto

Преимущества выбора стиля во время компиляции заключаются в том, что плагин QtQuick.Controls не используется и, следовательно, не должен развёртываться с приложением.

Выбор стиля во время выполнения

Выбор стиля во время выполнения включает импорт QtQuick.Controls:

import QtQuick.Controls

Плагин QtQuick.Controls импортирует стиль и стиль по умолчанию, которые были установлены во время выполнения одним из следующих способов:

• QQuickStyle::setStyle()
• Аргумент командной строки -style
• Переменная среды QT_QUICK_CONTROLS_STYLE
• Конфигурационный файл qtquickcontrols2.conf

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

Преимущества выбора стиля во время выполнения заключаются в том, что один двоичный файл приложения может поддерживать несколько стилей, что означает, что конечный пользователь может выбрать стиль, с которым приложение будет работать.

Использование 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