Back to Qt.io
Contact Us Blog Download Qt

QQuickStyle Class

Die Klasse QQuickStyle ermöglicht die Konfiguration des Anwendungsstils. 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)

Detaillierte Beschreibung

QQuickStyle bietet eine API zum Abfragen und Konfigurieren der Anwendungsstile von 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();
}

Hinweis: Der Stil muss vor dem Laden von QML, die Qt Quick Controls importiert, konfiguriert werden. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert worden sind.

Hinweis: QQuickStyle wird nicht unterstützt, wenn die Stilauswahl zur Kompilierzeit verwendet wird.

Um Ihren eigenen benutzerdefinierten Stil zu erstellen, siehe Erstellen eines benutzerdefinierten Stils. Benutzerdefinierte Stile müssen nicht alle Steuerelemente implementieren. Standardmäßig verwendet das Styling-System den Basic-Stil 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 Styling Qt Quick Controls.

Dokumentation der Mitgliedsfunktionen

[static] QString QQuickStyle::name()

Gibt den Namen des Anwendungsstils zurück.

Hinweis: Der Anwendungsstil kann durch Übergabe eines -style Befehlszeilenarguments angegeben werden. Daher gibt name() möglicherweise keinen vollständig aufgelösten Wert zurück, wenn es vor der Erstellung eines QGuiApplication aufgerufen wird.

[static] void QQuickStyle::setFallbackStyle(const QString &style)

Setzt den Fallback-Stil der Anwendung auf style.

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, die Qt Quick Controls importiert, konfiguriert werden. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert worden sind.

Der Fallback-Stil kann auch durch Setzen der Umgebungsvariablen QT_QUICK_CONTROLS_FALLBACK_STYLE festgelegt werden.

Siehe auch setStyle() und Verwendung von Stilen in Qt Quick Controls.

[static] void QQuickStyle::setStyle(const QString &style)

Setzt den Anwendungsstil auf style.

Hinweis: Der Stil muss vor dem Laden von QML, das Qt Quick Controls importiert, konfiguriert werden. Es ist nicht möglich, den Stil zu ändern, nachdem die QML-Typen registriert worden sind.

Siehe auch setFallbackStyle() und Stile verwenden in Qt Quick Controls.

© 2025 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.