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

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

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

Базовый стиль

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

Стиль Fusion

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

Стиль Imagine

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

Стиль macOS

Стиль macOS — стиль с родственным видом для macOS.

Стиль Material

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

Стиль Universal

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

Стиль Windows

Стиль Windows — стиль с родственным видом для Windows.

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