Класс QQuickStyle

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

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

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

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

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

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

#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 2. Изменить стиль после регистрации типов QML невозможно.

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

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

См. также Стиль Qt Quick Controls 2.

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

[static] QStringList QQuickStyle::availableStyles()

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

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

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

[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 2, например, "Material".

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

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

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

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

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

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

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

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