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