En esta página

ColorGroup QML Type

El conjunto de colores por roles. Más...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

Propiedades

Señales

Descripción detallada

El tipo ColorGroup se utiliza para definir un conjunto de colores con determinadas funciones. Aunque un ColorGroup no tiene apariencia visual, define colores utilizados para personalizar elementos renderizados.

Los valores por defecto de los colores son iguales a los colores de los grupos activos construidos por defecto en QPalette.

El siguiente código se puede utilizar para crear un grupo de color con algunos colores especificados:

ColorGroup {
    alternateBase: "red"
    base: "green"
}

El tipo Palette expone grupos de colores para cada estado de elemento QML.

Documentación de propiedades

accent : color [since 6.6]

Un color que suele contrastar o complementar los colores base, window y button. Suele representar la opción de personalización del escritorio elegida por los usuarios. El estilo de los componentes interactivos es un caso de uso típico. A menos que se establezca explícitamente, su valor predeterminado es highlight.

Esta propiedad se introdujo en Qt 6.6.

alternateBase : color

Se utiliza como color de fondo alternativo en las vistas de artículos con colores de fila alternos.

base : color

Se utiliza sobre todo como color de fondo para los controles del editor de texto y las vistas de elementos. Suele ser blanco u otro color claro.

brightText : color

Un color de texto muy diferente de windowText, que contrasta bien, por ejemplo, con dark. Suele utilizarse para texto que debe dibujarse en lugares en los que text, windowText o buttonText darían poco contraste, como en los botones resaltados.

button : color

El color de fondo general de los botones. Este fondo puede ser diferente de window ya que algunos estilos requieren un color de fondo diferente para los botones.

buttonText : color

Un color de primer plano utilizado con el color palette.

dark : color

Un color de primer plano utilizado con el color palette.

highlight : color

Un color para indicar un elemento seleccionado o el elemento actual.

highlightedText : color

Un color de texto que contrasta con highlight.

light : color

Más ligero que button.

Color del texto utilizado para los hipervínculos.

linkVisited : color

Color del texto utilizado para los hipervínculos ya visitados.

mid : color

Entre palette.button y dark.

midlight : color

Entre button y light.

placeholderText : color [since 6.2]

Se utiliza como color de marcador de posición para campos editables de una sola línea.

Esta propiedad se introdujo en Qt 6.2.

shadow : color

Un color muy oscuro.

text : color

El color de primer plano utilizado con base. Suele ser el mismo que el de windowText, en cuyo caso debe proporcionar un buen contraste con window y base.

toolTipBase : color

Se utiliza como color de fondo para los tooltips.

toolTipText : color

Se utiliza como color de primer plano para la información sobre herramientas.

window : color

Un color de fondo general.

windowText : color

Un color de primer plano general.

Documentación de señales

changed()

La señal adicional indica que el estado actual de este grupo de colores ha cambiado. Normalmente significa que uno de los colores ha cambiado.

Nota: El manejador correspondiente es onChanged.

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