En esta página

RadialGradient QML Type

Dibuja un degradado radial. 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 centro del elemento y terminan en los bordes.

Efecto aplicado

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    RadialGradient {
        anchors.fill: parent
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 0.5; color: "black" }
        }
    }
}

Documentación de propiedades

angle : real

Esta propiedad define la rotación del degradado alrededor de su punto central. La rotación sólo es visible cuando las propiedades horizontalRadius y verticalRadius no son iguales. El ángulo se da en grados y el valor por defecto es 0.

Ejemplos de salida con diferentes valores de ángulo

ángulo: 0 ángulo 45 ángulo: 90
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0
horizontalRadius: 100horizontalRadius: 100horizontalRadius: 100
verticalRadius: 300verticalRadius: 300verticalRadius: 300

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.

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 estableciendo la propiedad position. El color se define estableciendo 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"
  }
}
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0
horizontalRadius: 300horizontalRadius: 300horizontalRadius: 300
verticalRadius: 300verticalRadius: 300verticalRadius: 300
angle: 0angle: 0angle: 0

horizontalOffset : real

Las propiedades horizontalOffset y verticalOffset definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.

Los valores van de -inf a inf. Por defecto, estas propiedades se establecen en 0.

Ejemplos de salida con diferentes valores de horizontalOffset

horizontalOffset: -150 horizontalOffset: 0 horizontalOffset: 150
verticalOffset: 0verticalOffset: 0verticalOffset: 0
horizontalRadius: 300horizontalRadius: 300horizontalRadius: 300
verticalRadius: 300verticalRadius: 300verticalRadius: 300
angle: 0angle: 0angle: 0

horizontalRadius : real

Las propiedades horizontalRadius y verticalRadius definen la forma y el tamaño del degradado radial. Si los radios son iguales, la forma del gradiente es un círculo. Si los radios horizontal y vertical difieren, la forma es elíptica. Los radios se expresan en píxeles.

El valor oscila entre -inf e inf. Por defecto, horizontalRadius está ligado a la anchura y verticalRadius está ligado a la altura.

Ejemplos de salida con diferentes valores de horizontalRadius

radiohorizontal 300 radiohorizontal: 100
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0
verticalRadius: 300verticalRadius: 300
angle: 0angle: 0
gradient: QQuickGradient(0xa05fb10)gradient: QQuickGradient(0xa05fb10)

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 }
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0
horizontalRadius: 300horizontalRadius: 300
verticalRadius: 300verticalRadius: 300
angle: 0angle: 0

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

verticalOffset : real

Las propiedades horizontalOffset y verticalOffset definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.

Los valores van de -inf a inf. Por defecto, estas propiedades tienen el valor 0.

Ejemplos de salida con diferentes valores de horizontalOffset

horizontalOffset: -150 horizontalOffset: 0 horizontalOffset: 150
verticalOffset: 0verticalOffset: 0verticalOffset: 0
horizontalRadius: 300horizontalRadius: 300horizontalRadius: 300
verticalRadius: 300verticalRadius: 300verticalRadius: 300
angle: 0angle: 0angle: 0

verticalRadius : real

Las propiedades horizontalRadius y verticalRadius definen la forma y el tamaño del gradiente radial. Si los radios son iguales, la forma del gradiente es un círculo. Si los radios horizontal y vertical difieren, la forma es elíptica. Los radios se expresan en píxeles.

El valor oscila entre -inf e inf. Por defecto, horizontalRadius está vinculado a la anchura y VerticalRadius a la altura.

Ejemplos de salida con diferentes valores de horizontalRadius

horizontalRadius: 300 horizontalRadius: 100
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0
radiovertical 300radiovertical: 300
angle: 0angle: 0
gradient: QQuickGradient(0xa05fb10)gradient: QQuickGradient(0xa05fb10)

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