En esta página

LinearGradient QML Type

Dibuja un degradado lineal. Más...

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

Item

Propiedades

Descripción detallada

Un degradado se define mediante dos o más colores que se mezclan de forma homogénea. Los colores comienzan en el punto de inicio indicado y terminan en el punto final indicado.

Efecto aplicado

Degradado lineal de blanco a negro

{Degradado lineal de blanco a negro}

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

end : variant

Esta propiedad define el punto final en el que se representa el color correspondiente a la posición 1,0 del degradado. Los colores en posiciones con valores menores se representan linealmente hacia el punto inicial. El punto se expresa en píxeles y el valor por defecto es Qt.point(0, height). Al establecer los valores por defecto para « start » y «end», se obtiene un degradado lineal a lo largo de toda la altura en el eje y.

Ejemplos de resultados con diferentes valores de fin

Degradado que termina en la esquina inferior derecha

Degradado que termina en el centro

Degradado que termina en la esquina superior derecha

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

gradient : Gradient

Un degradado se define mediante dos o más colores que se mezclan de forma homogénea. Los colores se especifican como un conjunto de elementos secundarios de tipo « GradientStop », cada uno de los cuales define una posición en el degradado comprendida entre 0,0 y 1,0, así como un color. La posición de cada « GradientStop » viene determinada por la propiedad «position», mientras que el color viene determinado por la propiedad «color».

Ejemplos de resultados con diferentes valores de degradado

Degradado lineal de arcoíris

Degradado lineal gris

Degradado de transparente a negro

gradient:
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 un degradado. El elemento de origen se representa 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 degradado en la pantalla. El valor por defecto de «source» es indefinido y, en ese caso, toda el área del efecto se rellena con el degradado.

Ejemplos de resultados con diferentes valores de «source»

Relleno con degradado en toda la superficie

Degradado enmascarado por una forma de mariposa

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

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

start : variant

Esta propiedad define el punto inicial en el que se representa el color en la posición 0,0 del degradado. Los colores en posiciones mayores se representan de forma lineal hacia el punto final. El punto se expresa en píxeles y el valor por defecto es Qt.point(0, 0). Al establecer los valores por defecto para el inicio y end, se obtiene un degradado lineal a lo largo de toda la altura en el eje y.

Ejemplos de resultados con diferentes valores de inicio

Degradado que comienza en la esquina superior izquierda

Degradado que parte del centro

Degradado que comienza en la esquina superior derecha

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.