QQuickStyle Class▲
-
Header: QQuickStyle
-
Since: Qt 5.7
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)
-
qmake: QT += quickcontrols2
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();
}
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.
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"
);
See Also▲
See also Styling Qt Quick Controls
Member Function Documentation▲
[static] QString QQuickStyle::name()▲
Returns the name of the application style.
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, since 5.8] void QQuickStyle::setFallbackStyle(const QString &style)▲
Sets the application fallback style to style.
The fallback style must be the name of one of the built-in Qt Quick Controls styles, e.g. "Material".
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.
This function was introduced in Qt 5.8.
See Also▲
See also setStyle(), Using Styles in Qt Quick Controls
[static] void QQuickStyle::setStyle(const QString &style)▲
Sets the application style to style.
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.
See Also▲
See also setFallbackStyle(), Using Styles in Qt Quick Controls