QQuickStyle Class
Mit der Klasse „QQuickStyle“ lässt sich der Stil der Anwendung konfigurieren. Mehr...
| Kopfzeile: | #include <QQuickStyle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS QuickControls2) target_link_libraries(mytarget PRIVATE Qt6::QuickControls2) |
| qmake: | QT += quickcontrols2 |
Statische öffentliche Mitglieder
| QString | name() |
| void | setFallbackStyle(const QString &style) |
| void | setStyle(const QString &style) |
Ausführliche Beschreibung
QQuickStyle stellt eine API zum Abfragen und Konfigurieren der Anwendungsstile von Qt Quick Controls bereit.
#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();
}Hinweis: Der Stil muss vor dem Laden der QML-Datei konfiguriert werden, die „ Qt Quick Controls “ importiert. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert wurden.
Hinweis: QQuickStyle wird bei der Verwendung der Stilauswahl zur Kompilierungszeit nicht unterstützt.
Informationen zum Erstellen eines eigenen benutzerdefinierten Stils finden Sie unter „Erstellen eines benutzerdefinierten Stils“. Benutzerdefinierte Stile müssen nicht alle Steuerelemente implementieren. Standardmäßig verwendet das Styling-System den Stil „Basic“ als Fallback für Steuerelemente, die ein benutzerdefinierter Stil nicht bereitstellt. Es ist möglich, einen anderen Fallback-Stil anzugeben, um einen der integrierten Stile anzupassen oder zu erweitern.
QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");Siehe auch „ Qt Quick Controls gestalten“.
Dokumentation zu Mitgliedsfunktionen
[static] QString QQuickStyle::name()
Gibt den Namen des Anwendungsstils zurück.
Hinweis: Der Anwendungsstil kann durch Übergabe des Befehlszeilenarguments „ -style “ angegeben werden. Daher gibt „ name() “ möglicherweise keinen vollständig aufgelösten Wert zurück, wenn die Funktion vor dem Erstellen eines „ QGuiApplication “ aufgerufen wird.
[static] void QQuickStyle::setFallbackStyle(const QString &style)
Legt den Fallback-Stil der Anwendung auf „ style “ fest.
Hinweis: Der Fallback-Stil muss der Name eines der integrierten „ Qt Quick Controls “-Stile sein, z. B. „Material“.
Hinweis: Der Stil muss vor dem Laden von QML-Dateien konfiguriert werden, die „ Qt Quick Controls “ importieren. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert wurden.
Der Fallback-Stil kann auch durch Setzen der Umgebungsvariable „ QT_QUICK_CONTROLS_FALLBACK_STYLE “ festgelegt werden.
Siehe auch „ setStyle()“ und „Verwendung von Stilen“ unter Qt Quick Controls.
[static] void QQuickStyle::setStyle(const QString &style)
Legt den Anwendungsstil auf „ style “ fest.
Hinweis: Der Stil muss vor dem Laden von QML-Dateien konfiguriert werden, die „ Qt Quick Controls “ importieren. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert wurden.
Siehe auch „ setFallbackStyle()“ und „Verwendung von Stilen“ unter Qt Quick Controls.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
