En esta página

ColorOverlay QML Type

Modifica los colores del elemento de origen aplicando un color de superposición. Más...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propiedades

Descripción detallada

El efecto es similar al que se produce cuando se superpone un cristal de color sobre una imagen en escala de grises. El color de la superposición se especifica en formato ARGB.

FuenteEfecto aplicado

Ilustración de una mariposa de colores

Mariposa con superposición de color aplicada

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ColorOverlay {
        anchors.fill: bug
        source: bug
        color: "#80800000"
    }
}

Documentación de propiedades

cached : bool

Esta propiedad permite almacenar en caché los píxeles de salida del efecto con el fin de mejorar el rendimiento del renderizado.

Cada vez que se modifican las propiedades de la fuente o del efecto, es necesario actualizar los píxeles de la caché. El consumo de memoria aumenta, ya que se requiere un búfer de memoria adicional para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando las propiedades de la fuente o del efecto estén animadas.

Por defecto, la propiedad está establecida en « false ».

color : color

Esta propiedad define el valor de color que se utiliza para colorear el texto de origen.

Por defecto, la propiedad está establecida en "transparent".

Ejemplos de resultados con diferentes valores de color

Mariposa con superposición roja

Mariposa con superposición verde

Mariposa con superposición azul

color: #80ff0000 color: #8000ff00 color: #800000ff

source : variant

Esta propiedad define el elemento de origen que proporciona los píxeles de origen para el efecto.

Nota: Noestá permitido que el efecto se incluya a sí mismo, por ejemplo, estableciendo «source» como el elemento padre del efecto.

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