En esta página

LinearGradient QML Type

Dibuja un gradiente lineal. Más...

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

Item

Propiedades

Descripción detallada

Un degradado está definido por dos o más colores, que se mezclan a la perfección. Los colores empiezan en el punto inicial y terminan en el punto final.

Efecto aplicado

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    LinearGradient {
        anchors.fill: parent
        start: Qt.point(0, 0)
        end: Qt.point(0, 300)
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

Documentación de propiedades

cached : bool

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

Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.

Por defecto, la propiedad está establecida en false.

end : variant

Esta propiedad define el punto final donde se renderiza el color en la posición de gradiente de 1.0. Los colores en valores de posición menores se renderizan linealmente hacia el punto inicial. El punto se da en píxeles y el valor por defecto es Qt.point(0, height). Establecer los valores por defecto para start y el final da como resultado un gradiente lineal de altura completa en el eje y.

Ejemplos de salida con diferentes valores de end

end: Qt.point(300, 300) end: Qt.point(150, 150) fin: Qt.point(300, 0)
start: Qt.point(0, 0)start: Qt.point(0, 0)start: Qt.point(0, 0)

gradient : Gradient

Un degradado está definido por dos o más colores, que se mezclan a la perfección. Los colores se especifican como un conjunto de elementos hijos de GradientStop, cada uno de los cuales define una posición en el degradado de 0,0 a 1,0 y un color. La posición de cada GradientStop se define mediante la propiedad position, y el color se define mediante la propiedad color.

Ejemplos de salida con diferentes valores de gradiente

gradiente:
Gradient {
  GradientStop {
     position: 0.000
     color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
     position: 0.167
     color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
     position: 0.333
     color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
     position: 0.500
     color: Qt.rgba(0, 1, 1, 1)
  }
  GradientStop {
     position: 0.667
     color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
     position: 0.833
     color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
     position: 1.000
     color: Qt.rgba(1, 0, 0, 1)
  }
}
gradiente:
Gradient {
  GradientStop {
    position: 0.0
    color: "#F0F0F0"
  }
  GradientStop {
    position: 0.5
    color: "#000000"
  }
  GradientStop {
    position: 1.0
    color: "#F0F0F0"
  }
}
gradiente:
Gradient {
  GradientStop {
    position: 0.0
    color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}
start: Qt.point(0, 0)start: Qt.point(0, 0)start: Qt.point(0, 0)
end: Qt.point(300, 300)end: Qt.point(300, 300)end: Qt.point(300, 300)

source : variant

Esta propiedad define el elemento que se va a rellenar con gradiente. El elemento fuente se renderiza en un búfer de píxeles intermedio y los valores alfa del resultado se utilizan para determinar la visibilidad de los píxeles del gradiente en la pantalla. El valor por defecto para la fuente es indefinido y en ese caso toda el área del efecto se rellena con degradado.

Ejemplos de salida con diferentes valores de fuente

fuente: indefinido fuente: Imagen { source: images/butterfly.png }
start: Qt.point(0, 0)start: Qt.point(0, 0)
end: Qt.point(300, 300)end: Qt.point(300, 300)

Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo estableciendo como fuente el padre del efecto.

start : variant

Esta propiedad define el punto inicial en el que se renderiza el color en la posición de gradiente 0.0. Los colores en valores de posición mayores se renderizan linealmente hacia el punto final. El punto se da en píxeles y el valor por defecto es Qt.point(0, 0). Establecer los valores por defecto para el inicio y end da como resultado un gradiente lineal de altura completa en el eje y.

Ejemplos de salida con diferentes valores de inicio

inicio: QPoint(0, 0) inicio: QPoint(150, 150) inicio: QPoint(300, 0)
end: QPoint(300, 300)end QPoint(300, 300)end: QPoint(300, 300)

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