En esta página

QQuickStyle Class

La clase QQuickStyle permite configurar el estilo de la aplicación. Más información...

Encabezado: #include <QQuickStyle>
CMake: find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)
qmake: QT += quickcontrols2

Miembros públicos estáticos

QString name()
void setFallbackStyle(const QString &style)
void setStyle(const QString &style)

Descripción detallada

QQuickStyle proporciona una API para consultar y configurar los estilos de aplicación de los controles de Qt Quick.

#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();
}

Nota: El estilo debe configurarse antes de cargar el QML que importa los controles de Qt Quick. No es posible cambiar el estilo una vez que se han registrado los tipos QML.

Nota: QQuickStyle no es compatible cuando se utiliza la selección de estilos en tiempo de compilación.

Para crear tu propio estilo personalizado, consulta Creación de un estilo personalizado. Los estilos personalizados no tienen por qué implementar todos los controles. De forma predeterminada, el sistema de estilos utiliza el estilo «Basic» como estilo de reserva para los controles que no cubre un estilo personalizado. Es posible especificar un estilo de reserva diferente para personalizar o ampliar uno de los estilos integrados.

QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");

Véase también «Aplicaciónde estilos alos controles de Qt Quick ».

Documentación de las funciones de miembro

[static] QString QQuickStyle::name()

Devuelve el nombre del estilo de la aplicación.

Nota: El estilo de la aplicación se puede especificar pasando el argumento de línea de comandos « -style ». Por lo tanto, es posible que « name() » no devuelva un valor completamente resuelto si se invoca antes de crear un « QGuiApplication ».

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

Establece el estilo alternativo de la aplicación en « style ».

Nota: El estilo de reserva debe ser el nombre de uno de los estilos integrados de los controles « Qt Quick », por ejemplo, «Material».

Nota: El estilo debe configurarse antes de cargar el QML que importa los controles « Qt Quick ». No es posible cambiar el estilo una vez que se han registrado los tipos QML.

El estilo de reserva también se puede especificar configurando la variable de entorno` QT_QUICK_CONTROLS_FALLBACK_STYLE `.

Véase también setStyle() y Uso de estilos en los controles de Qt Quick .

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

Establece el estilo de la aplicación en « style ».

Nota: El estilo debe configurarse antes de cargar el QML que importa los controles de Qt Quick. No es posible cambiar el estilo una vez que se han registrado los tipos QML.

Véase también ` setFallbackStyle()` y «Uso de estilos en los controles de Qt Quick ».

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