Класс QQuickStyle

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

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

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

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

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

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] 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 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.

[static] QStringList QQuickStyle::stylePathList()

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

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

Функция была добавлена в Qt 5.12.

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