Класс QQuickStyle

Класс QQuickStyle позволяет настроить стиль приложения. Подробнее...

Этот класс был представлен в Qt 5.7.

• Список всех членов, включая унаследованные

Статические публичные члены

Подробное описание

QQuickStyle предоставляет API для запроса и настройки стилей приложения стилей Qt Quick Controls.

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQuickStyle>

int main(int argc, char *argv[])
{
    QGuiApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QGuiApplication app(argc, argv);

    QQuickStyle::setStyle("Material");

    QQmlApplicationEngine engine;
    engine.load(QUrl("qrc:/main.qml"));

    return app.exec();
}

Примечание: Стиль необходимо настроить перед загрузкой QML, который импортирует Qt Quick Controls. Изменить стиль после регистрации типов QML невозможно.

Стиль также можно указать как путь к пользовательскому стилю, например ":/mystyle". Подробнее о создании пользовательских стилей см. в разделе Создание пользовательского стиля. Пользовательские стили не обязаны реализовывать все элементы управления. По умолчанию система стилизации использует стиль по умолчанию в качестве резервного для элементов управления, которые не поддерживаются пользовательским стилем. Можно указать другой резервный стиль для настройки или расширения одного из встроенных стилей.

QQuickStyle::setStyle(":/mystyle");
QQuickStyle::setFallbackStyle("Material");

См. также Стилизация Qt Quick Controls.

Документация по функциям-членам

[static] void QQuickStyle::addStylePath(const QString &path)

Добавляет path в качестве каталога, в котором Qt Quick Controls 2 ищет доступные стили.

path может быть любым локальным каталогом файловой системы или каталогом ресурсов Qt. Например, следующие пути являются допустимыми:

• /path/to/styles/
• file:///path/to/styles/
• :/path/to/styles/
• qrc:/path/to/styles/)

path будет преобразован в каноническую форму перед добавлением в список путей стиля.

Новый добавленный path будет первым в stylePathList().

Эта функция была представлена в Qt 5.12.

См. также stylePathList() и availableStyles().

[static] QStringList QQuickStyle::availableStyles()

Возвращает имена доступных стилей.

Примечание: Метод необходимо вызывать после создания экземпляра QGuiApplication.

Эта функция была представлена в Qt 5.9.

См. также stylePathList() и addStylePath().

[static] QString QQuickStyle::name()

Возвращает имя стиля приложения.

Примечание: Стиль приложения можно указать, передав -style аргумент командной строки. Поэтому name() может не вернуть полностью решенное значение, если вызвано до построения QGuiApplication.

[static] QString QQuickStyle::path()

Возвращает путь к переопределенному стилю приложения или пустую строку, если стиль является одним из встроенных стилей Qt Quick Controls 2.

Примечание: Стиль приложения можно указать, передав -style аргумент командной строки. Поэтому path() может не вернуть полностью решенное значение, если вызвано до построения QGuiApplication.

[static] void QQuickStyle::setFallbackStyle(const QString &style)

Устанавливает резервный стиль приложения на style.

Примечание: резервный стиль должен быть именем одного из встроенных стилей Qt Quick Controls, например, "Material".

Примечание: Стиль необходимо настроить перед загрузкой QML, который импортирует Qt Quick Controls. Изменить стиль после регистрации типов QML невозможно.

Резервный стиль также можно указать, установив QT_QUICK_CONTROLS_FALLBACK_STYLE переменную среды.

Эта функция была представлена в Qt 5.8.

См. также setStyle() и Использование стилей в Qt Quick Controls.

[static] void QQuickStyle::setStyle(const QString &style)

Устанавливает стиль приложения на style.

Примечание: Стиль необходимо настроить перед загрузкой QML, который импортирует Qt Quick Controls. Изменить стиль после регистрации типов QML невозможно.

См. также setFallbackStyle() и Использование стилей в Qt Quick Controls.

[static] QStringList QQuickStyle::stylePathList()

Возвращает список каталогов, в которых Qt Quick Controls 2 ищет доступные стили.

По умолчанию список содержит пути, указанные в QT_QUICK_CONTROLS_STYLE_PATH переменной среды, и любые существующие QtQuick/Controls.2 подкаталоги в QQmlEngine::importPathList().

Эта функция была представлена в Qt 5.12.

См. также addStylePath() и availableStyles().