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
- accent: color
- fondo: color
- primer plano: color
- tema: enumeración
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.
El tema claro del 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.

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") } } } |
|
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
| Variable | Descripción |
|---|---|
Theme | Especifica el tema Universal por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark". |
Accent | Especifica 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". |
Foreground | Especifica el color de primer plano predeterminado de Universal. El valor puede ser cualquiera color, o uno de los colores Universal predefinidos, por ejemplo "Brown". |
Background | Especifica 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
| Variable | Descripción |
|---|---|
QT_QUICK_CONTROLS_UNIVERSAL_THEME | Especifica el tema Universal por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark". |
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT | Especifica 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_FOREGROUND | Especifica 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_BACKGROUND | Especifica 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:
| Constante | Descripció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 } |
|
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:
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 } |
|
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:
| Constante | Descripción |
|---|---|
Universal.Light | Tema claro (por defecto) |
Universal.Dark | Tema oscuro |
Universal.System | Tema 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:
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) }
Información relacionada
© 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.






