Estilo universal
El estilo universal se basa en las Directrices de Diseño Universal de Microsoft. Más información...
| Declaración de importación: | import QtQuick.Controls.Universal |
| Desde: | Qt 5.7 |
Propiedades asociadas
- accent: color
- fondo: color
- primer plano: color
- tema: enumeración
Métodos asociados
- 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» se ha diseñado para que se vea bien en todos los dispositivos, desde teléfonos y tabletas hasta ordenadores.
El tema claro del estilo «Universal». |
El tema oscuro del estilo «Universal». |
Para ejecutar una aplicación con el estilo universal, consulta «Uso de estilos en los controles de Qt Quick ».
Nota: El estilo «Universal» no es un estilo nativo de Windows 10. El estilo «Universal» es una implementación de los controles « Qt Quick » 100 % multiplataforma que sigue las Directrices de diseño universal de Microsoft. El estilo funciona en cualquier plataforma y tiene un aspecto prácticamente idéntico en todas ellas. Pueden producirse pequeñas diferencias debido a las variaciones en las fuentes del sistema disponibles 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 se pueden especificar para cualquier ventana o elemento, y se aplican automáticamente a los elementos secundarios de la misma manera que en « fonts ». En el siguiente ejemplo, la ventana y los tres botones de opción aparecen con el tema oscuro y un color de acento violeta:
|
|
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.
Archivo de configuración
| Variable | Descripción |
|---|---|
Theme | Especifica el tema Universal predeterminado. El valor puede ser cualquiera de los temas disponibles, por ejemplo, "Dark". |
Accent | Especifica el color de acento predeterminado de Universal. El valor puede ser cualquier 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 cualquier color o uno de los colores predefinidos de Universal, por ejemplo, "Brown". |
Background | Especifica el color de fondo predeterminado de Universal. El valor puede ser cualquier color o uno de los colores predefinidos de Universal, por ejemplo, "Steel". |
Consulte el archivo de configuración de controles deQt Quick para obtener más detalles sobre el archivo de configuración.
Variables de entorno
| Variable | Descripción |
|---|---|
QT_QUICK_CONTROLS_UNIVERSAL_THEME | Especifica el tema Universal predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, "Dark". |
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT | Especifica el color de acento predeterminado de Universal. El valor puede ser cualquier 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 cualquier color o uno de los colores predefinidos de Universal, 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 predefinidos de Universal, por ejemplo, "Steel". |
Consulte «Variables de entorno compatibles» en «Controles de Qt Quick » 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 de dicho estilo. Cabe señalar que, independientemente de las referencias al estilo «Universal», el mismo código de la aplicación se ejecuta con cualquier otro estilo. Los atributos específicos del estilo «Universal» solo surten efecto cuando la aplicación se ejecuta con dicho estilo.
Si el estilo «Universal» se importa en un archivo QML que se carga siempre, dicho estilo debe implementarse junto con la aplicación para que esta pueda ejecutarse independientemente del estilo con el que se utilice. Mediante el uso de selectores de archivos, se pueden aplicar ajustes específicos del estilo sin crear una dependencia rígida de un estilo concreto.
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 predeterminado) |
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 |
Véase también «Estilo básico», «Estilo de material»
Documentación sobre propiedades asociadas
Universal.accent: color |
Esta propiedad asociada contiene el color de acento del tema. La propiedad se puede asociar a cualquier ventana o elemento. El valor se propaga a los elementos secundarios.
El valor por defecto es Universal.Cobalt.
En el siguiente ejemplo, el color de acento del botón resaltado se cambia a Universal.Orange:
|
|
Nota: Aunque el color de acento puede ser cualquier color, se recomienda utilizar uno de los colores universales predefinidos que se han diseñado para combinar bien con el resto de la paleta de estilos universales.
Universal.background: color |
Esta propiedad asociada contiene el color de fondo del tema. La propiedad se puede asociar a cualquier ventana o elemento. El valor se propaga a los elementos secundarios.
El valor por defecto depende 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 asociada contiene el color de primer plano del tema. La propiedad se puede asociar a cualquier ventana o elemento. El valor se propaga a los elementos secundarios.
El valor por defecto depende del tema (claro u oscuro).
En el siguiente ejemplo, el color de primer plano del botón se establece en « Universal.Pink »:
|
|
Universal.theme: enumeración |
Esta propiedad adjunta indica si el tema es claro u oscuro. La propiedad se puede adjuntar a cualquier ventana o elemento. El valor se propaga a los elementos secundarios.
Temas disponibles:
| Constante | Descripción |
|---|---|
Universal.Light | Tema claro (predeterminado) |
Universal.Dark | Tema oscuro |
Universal.System | Tema del sistema |
Al establecer el tema en « System », se elige el tema claro u oscuro en función de los colores del tema del sistema. Sin embargo, al leer el valor de la propiedad «theme», el valor nunca es « System », sino el tema real.
En el siguiente ejemplo, el tema tanto del panel como del botón se establece en « Universal.Dark »:
Documentación del método adjunta
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.






