En esta página

QStylePlugin Class

La clase QStylePlugin proporciona una base abstracta para los complementos personalizados de QStyle. Más información...

Encabezado: #include <QStylePlugin>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QObject

Funciones públicas

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

Descripción detallada

QStylePlugin es una interfaz de complemento sencilla que facilita la creación de estilos personalizados que pueden cargarse dinámicamente en aplicaciones mediante la clase QStyleFactory.

Para escribir un complemento de estilo, hay que crear una subclase de esta clase base, reimplementar la función virtual pura ` create()` y exportar la clase mediante la macro ` Q_PLUGIN_METADATA()`.

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;
    QStringList keys() const;
};

El archivo de metadatos JSON mystyleplugin.json del complemento debe contener información sobre los nombres de los estilos que admite el complemento, tal y como se indica a continuación:

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

Consulte «Cómo crear complementos de Qt » para obtener más detalles.

Véase también QStyleFactory y QStyle.

Documentación de las funciones de miembro

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

Crea un complemento de estilo con el archivo « parent » especificado.

Ten en cuenta que este constructor es invocado automáticamente por el código generado por moc que exporta el complemento, por lo que no es necesario llamarlo explícitamente.

[virtual noexcept] QStylePlugin::~QStylePlugin()

Destruye el complemento de estilo.

Ten en cuenta que Qt destruye un complemento automáticamente cuando ya no se utiliza, por lo que no es necesario llamar al destructor de forma explícita.

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

Crea y devuelve un objeto ` QStyle ` para el estilo indicado ` key`. Si un complemento no puede crear un estilo, debe devolver 0 en su lugar.

La clave «style» suele ser el nombre de la clase del estilo requerido. Ten en cuenta que las claves no distinguen entre mayúsculas y minúsculas. Por ejemplo:

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;
}

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