QStylePlugin Class

Die Klasse QStylePlugin bietet eine abstrakte Basis für eigene QStyle Plugins. Mehr...

Kopfzeile:	`#include <QStylePlugin>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake:	`QT += widgets`
Vererbungen:	QObject

Liste aller Mitglieder, einschließlich geerbter Mitglieder
QStylePlugin ist Teil der Plugin-Klassen.

Öffentliche Funktionen

	QStylePlugin(QObject *parent = nullptr)
virtual	~QStylePlugin()
virtual QStyle *	create(const QString &key) = 0

Detaillierte Beschreibung

QStylePlugin ist eine einfache Plugin-Schnittstelle, die das Erstellen von benutzerdefinierten Styles erleichtert, die mit der Klasse QStyleFactory dynamisch in Anwendungen geladen werden können.

Um ein Style-Plugin zu schreiben, muss man diese Basisklasse unterklassifizieren, die rein virtuelle Funktion create() reimplementieren und die Klasse mit dem Makro Q_PLUGIN_METADATA() exportieren.

class MyStylePlugin : public QStylePlugin
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QStyleFactoryInterface" FILE "mystyleplugin.json")
public:
    MyStylePlugin(QObject *parent = nullptr);

    QStyle *create(const QString &key) override;
};

Die json-Metadaten-Datei mystyleplugin.json für das Plugin muss Informationen über die Namen der Stile enthalten, die das Plugin wie folgt unterstützt:

{ "Keys": [ "Rocket", "Starbuster" ] }

Siehe How to Create Qt Plugins für Details.

Siehe auch QStyleFactory und QStyle.

Dokumentation der Mitgliedsfunktionen

`[explicit]` QStylePlugin::QStylePlugin(QObject **parent* = nullptr)

Konstruiert ein Style-Plugin mit dem angegebenen parent.

Beachten Sie, dass dieser Konstruktor automatisch durch den von moc generierten Code aufgerufen wird, der das Plugin exportiert, so dass er nicht explizit aufgerufen werden muss.

`[virtual noexcept]` QStylePlugin::~QStylePlugin()

Zerstört das Style-Plugin.

Beachten Sie, dass Qt ein Plugin automatisch zerstört, wenn es nicht mehr verwendet wird, so dass es nicht notwendig ist, den Destruktor explizit aufzurufen.

`[pure virtual]` QStyle QStylePlugin::create(const QString &key*)

Erzeugt ein QStyle Objekt für den angegebenen Stil key und gibt es zurück. Wenn ein Plugin keinen Stil erstellen kann, sollte es stattdessen 0 zurückgeben.

Der Schlüssel des Stils ist normalerweise der Klassenname des gewünschten Stils. Beachten Sie, dass bei den Schlüsseln die Groß- und Kleinschreibung keine Rolle spielt. Zum Beispiel:

QStyle *MyStylePlugin::create(const QString &key)
{
    QString lcKey = key.toLower();
    if (lcKey == "rocket") {
        return new RocketStyle;
    } else if (lcKey == "starbuster") {
        return new StarBusterStyle;
    }
    return nullptr;
}

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