En esta página

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

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.

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

El tema claro del estilo «Universal».

Galería de controles con tema oscuro de 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.

Botones de estilo universal que muestran los atributos de tema y de color de contraste

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:

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") }
    }
}

Controles de estilo universal con detalles personalizados en color 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

VariableDescripción
ThemeEspecifica el tema Universal predeterminado. El valor puede ser cualquiera de los temas disponibles, por ejemplo, "Dark".
AccentEspecifica 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".
ForegroundEspecifica 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".
BackgroundEspecifica 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

VariableDescripción
QT_QUICK_CONTROLS_UNIVERSAL_THEMEEspecifica el tema Universal predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, "Dark".
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTEspecifica 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_FOREGROUNDEspecifica 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_BACKGROUNDEspecifica 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:

ConstanteDescripció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:

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

Controles de estilo universal que muestran el color de contraste

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:

Pane {
    Universal.background: Universal.Steel

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

Controles de estilo universal que muestran el color de fondo


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 »:

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 se puede adjuntar a cualquier ventana o elemento. El valor se propaga a los elementos secundarios.

Temas disponibles:

ConstanteDescripción
Universal.LightTema claro (predeterminado)
Universal.DarkTema oscuro
Universal.SystemTema 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 »:

Pane {
    Universal.theme: Universal.Dark

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

Controles de estilo universal en los temas claro y oscuro


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

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