class QQuickStyle

The QQuickStyle class allows configuring the application style. More

Synopsis

Static functions

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

QQuickStyle provides API for querying and configuring the application styles of Qt Quick Controls.

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

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickStyle::setStyle("Material");

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

    return app.exec();
}

Note

The style must be configured before loading QML that imports Qt Quick Controls. It is not possible to change the style after the QML types have been registered.

Note

QQuickStyle is not supported when using compile-time style selection .

To create your own custom style, see Creating a Custom Style . Custom styles do not need to implement all controls. By default, the styling system uses the Basic style as a fallback for controls that a custom style does not provide. It is possible to specify a different fallback style to customize or extend one of the built-in styles.

QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");
static name()
Return type:

str

Returns the name of the application style.

Note

The application style can be specified by passing a -style command line argument. Therefore name() may not return a fully resolved value if called before constructing a QGuiApplication.

static setFallbackStyle(style)
Parameters:

style – str

Sets the application fallback style to style.

Note

The fallback style must be the name of one of the built-in Qt Quick Controls styles, e.g. “Material”.

Note

The style must be configured before loading QML that imports Qt Quick Controls. It is not possible to change the style after the QML types have been registered.

The fallback style can be also specified by setting the QT_QUICK_CONTROLS_FALLBACK_STYLE environment variable .

static setStyle(style)
Parameters:

style – str

Sets the application style to style.

Note

The style must be configured before loading QML that imports Qt Quick Controls. It is not possible to change the style after the QML types have been registered.