Класс 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.