En esta página

Estilo universal

El Estilo Universal se basa en las Directrices de Diseño Universal de Microsoft. Más...

Declaración de Importación: import QtQuick.Controls.Universal
Desde: Qt 5.7

Propiedades adjuntas

Métodos adjuntos

  • color color(enumeración predefinida)

Descripción detallada

El estilo Universal es un estilo independiente del dispositivo basado en las directrices de diseño universal de Microsoft. El estilo Universal ha sido diseñado para verse bien en todos los dispositivos, desde teléfonos y tabletas hasta PC.

Galería de controles en el tema Universal style light

El tema claro del estilo Universal.

Galería de controles en el tema oscuro de estilo Universal

El tema oscuro del estilo Universal.

Para ejecutar una aplicación con el estilo Universal, consulte Uso de estilos en Qt Quick Controls.

Nota: El estilo Universal no es un estilo nativo de Windows 10. El estilo Universal es una implementación de estilo Qt Quick Controls 100% multiplataforma que sigue las Directrices de diseño universal de Microsoft. El estilo funciona en cualquier plataforma y tiene un aspecto más o menos idéntico en todas partes. Pueden producirse pequeñas diferencias debido a las diferencias en las fuentes disponibles en el sistema y en los motores de renderizado de fuentes.

Personalización

El estilo Universal permite personalizar cuatro atributos: tema, acento, primer plano y fondo.

Botones de estilo universal que muestran atributos de tema y acento

Ambos atributos pueden especificarse para cualquier ventana o elemento, y se propagan automáticamente a los hijos del mismo modo que fonts. En el siguiente ejemplo, la ventana y los tres botones de radio aparecen en el tema oscuro utilizando un color de acento violeta:

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Universal

ApplicationWindow {
    visible: true

    Universal.theme: Universal.Dark
    Universal.accent: Universal.Violet

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium");  checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Mandos de estilo universal con acento violeta personalizado

Además de especificar los atributos en QML, también es posible especificarlos mediante variables de entorno o en un archivo de configuración. Los atributos especificados en QML tienen prioridad sobre todos los demás métodos.

Fichero de configuración

VariableDescripción
ThemeEspecifica el tema Universal por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark".
AccentEspecifica el color de acento Universal por defecto. El valor puede ser cualquiera color, pero se recomienda utilizar uno de los colores predefinidos de Universal, por ejemplo "Violet".
ForegroundEspecifica el color de primer plano predeterminado de Universal. El valor puede ser cualquiera color, o uno de los colores Universal predefinidos, por ejemplo "Brown".
BackgroundEspecifica el color de fondo predeterminado de Universal. El valor puede ser cualquier color, o uno de los colores Universal predefinidos, por ejemplo "Steel".

Consulte Qt Quick Controls Archivo de configuración para obtener más información sobre el archivo de configuración.

Variables de entorno

VariableDescripción
QT_QUICK_CONTROLS_UNIVERSAL_THEMEEspecifica el tema Universal por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark".
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTEspecifica el color de acento Universal por defecto. El valor puede ser cualquiera color, pero se recomienda utilizar uno de los colores predefinidos de Universal, por ejemplo "Violet".
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUNDEspecifica el color de primer plano predeterminado de Universal. El valor puede ser cualquiera color, o uno de los colores Universal predefinidos, por ejemplo "Brown".
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUNDEspecifica el color de fondo predeterminado de Universal. El valor puede ser cualquier color, o uno de los colores Universal predefinidos, por ejemplo "Steel".

Consulte Variables de entorno compatibles en Qt Quick Controls para ver la lista completa de variables de entorno compatibles.

Dependencia

El estilo Universal debe importarse por separado para poder acceder a los atributos específicos del estilo Universal. Debe tenerse en cuenta que, independientemente de las referencias al estilo Universal, el mismo código de aplicación se ejecuta con cualquier otro estilo. Los atributos específicos de Universal sólo tienen efecto cuando la aplicación se ejecuta con el estilo Universal.

Si el estilo Universal se importa en un archivo QML que se carga siempre, el estilo Universal debe desplegarse con la aplicación para poder ejecutar la aplicación independientemente del estilo con el que se ejecute la aplicación. Mediante el uso de selectores de archivo, se pueden aplicar ajustes específicos de estilo sin crear una dependencia dura a un estilo.

Colores universales predefinidos

Colores predefinidos disponibles:

ConstanteDescripción
Universal.Lime
#A4C400
Universal.Green
#60A917
Universal.Emerald
#008A00
Universal.Teal
#00ABA9
Universal.Cyan
#1BA1E2
Universal.Cobalt
#3E65FF (acento por defecto)
Universal.Indigo
#6A00FF
Universal.Violet
#AA00FF
Universal.Pink
#F472D0
Universal.Magenta
#D80073
Universal.Crimson
#A20025
Universal.Red
#E51400
Universal.Orange
#FA6800
Universal.Amber
#F0A30A
Universal.Yellow
#E3C800
Universal.Brown
#825A2C
Universal.Olive
#6D8764
Universal.Steel
#647687
Universal.Mauve
#76608A
Universal.Taupe
#87794E

Ver también la sección Estilo básico, Estilo material

Documentación de propiedades adjuntas

Universal.accent: color

Esta propiedad adjunta contiene el color de acento del tema. La propiedad puede adjuntarse a cualquier ventana o elemento. El valor se propaga a los hijos.

El valor por defecto es Universal.Cobalt.

En el siguiente ejemplo, el color de acento del botón resaltado se cambia a Universal.Orange:

Button {
    text: qsTr("Button")
    highlighted: true
    Universal.accent: Universal.Orange
}

Controles de estilo universal que muestran el color de acento

Nota: Aunque el acento puede ser cualquiera color, se recomienda utilizar uno de los colores Universal predefinidos que han sido diseñados para funcionar bien con el resto de la paleta de estilos Universal.


Universal.background: color

Esta propiedad adjunta contiene el color de fondo del tema. La propiedad puede adjuntarse a cualquier ventana o elemento. El valor se propaga a los hijos.

El valor por defecto es específico del tema (claro u oscuro).

En el siguiente ejemplo, el color de fondo del panel se cambia a Universal.Steel:

Pane {
    Universal.background: Universal.Steel

    Button {
        text: qsTr("Button")
    }
}

Controles de estilo universal que muestran el color de fondo


Universal.foreground: color

Esta propiedad adjunta contiene el color de primer plano del tema. La propiedad puede adjuntarse a cualquier ventana o elemento. El valor se propaga a los hijos.

El valor por defecto es específico del tema (claro u oscuro).

En el siguiente ejemplo, el color de primer plano del botón es Universal.Pink:

Button {
    text: qsTr("Button")
    Universal.foreground: Universal.Pink
}

Controles de estilo universal que muestran el color de primer plano


Universal.theme: enumeración

Esta propiedad adjunta indica si el tema es claro u oscuro. La propiedad puede adjuntarse a cualquier ventana o elemento. El valor se propaga a los hijos.

Temas disponibles:

ConstanteDescripción
Universal.LightTema claro (por defecto)
Universal.DarkTema oscuro
Universal.SystemTema del sistema

Si se establece el tema en System, se elige el tema claro u oscuro basándose en los colores del tema del sistema. Sin embargo, cuando se lee el valor de la propiedad theme, el valor nunca es System, sino el tema actual.

En el siguiente ejemplo, el tema del panel y del botón es Universal.Dark:

Pane {
    Universal.theme: Universal.Dark

    Button {
        text: qsTr("Button")
    }
}

Controles de estilo universal en temas claros y oscuros


Documentación del método adjunto

color color(enumeración predefinida)

Este método adjunto devuelve el valor de color efectivo del color Universal predefinido especificado.

Rectangle {
    color: Universal.color(Universal.Red)
}

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