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 viene definido por dos o más colores que se funden entre sí de forma homogénea. Los colores comienzan en el centro del elemento y terminan en los bordes.

Efecto aplicado

Gradiente radial desde el centro hacia los bordes

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 solo es visible cuando las propiedades « horizontalRadius » y « verticalRadius » no son iguales. El ángulo se expresa en grados y el valor por defecto es « 0 ».

Ejemplos de resultados con diferentes valores de ángulo

Gradiente elíptico con ángulo 0

Gradiente elíptico con un ángulo de 45

Gradiente elíptico con un ángulo de 90

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

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, y un color. La posición de cada elemento « GradientStop » se define estableciendo la propiedad «position». El color se define estableciendo la propiedad «color».

Ejemplos de resultados con diferentes valores de degradado

Degradado radial arcoíris

Degradado radial 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"
  }
}
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 oscilan entre -inf e inf. Por defecto, estas propiedades están establecidas en 0.

Ejemplos de resultados con diferentes valores de `horizontalOffset`

Desplazamiento central del degradado hacia la izquierda

Centro del gradiente en el origen

Desplazamiento del centro del degradado hacia la derecha

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 degradado es un círculo. Si los radios horizontal y vertical son diferentes, la forma es elíptica. Los radios se expresan en píxeles.

El valor oscila entre -inf e inf. Por defecto, horizontalRadius está vinculado al ancho y verticalRadius está vinculado a la altura.

Ejemplos de resultados con diferentes valores de `horizontalRadius`

Forma con degradado circular

Forma de gradiente elíptico

horizontalRadius: 300 horizontalRadius: 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 el 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 resultado con diferentes valores de «source»

Relleno con degradado en toda la superficie

Degradado enmascarado por una forma de mariposa

source: undefined fuente: Imagen { fuente: images/butterfly.png }
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0
horizontalRadius: 300horizontalRadius: 300
verticalRadius: 300verticalRadius: 300
angle: 0angle: 0

Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento 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 oscilan entre -inf e inf. Por defecto, estas propiedades están establecidas en 0.

Ejemplos de resultados con diferentes valores de ` horizontalOffset `

Desplazamiento del centro del degradado hacia la izquierda

Centro del gradiente en el origen

Desplazamiento central del degradado hacia la derecha

horizontalOffset: -150 horizontalOffset: 0 horizontalOffset: 150
verticalOffset: 0desplazamiento vertical: 0desplazamiento vertical: 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 degradado radial. Si los radios son iguales, la forma del degradado es un círculo. Si los radios horizontal y vertical son diferentes, la forma es elíptica. Los radios se expresan en píxeles.

El valor oscila entre -inf e inf. Por defecto, horizontalRadius se vincula a width y verticalRadius se vincula a height.

Ejemplos de resultados con diferentes valores de ` horizontalRadius `

Forma con degradado circular

Forma elíptica con degradado

horizontalRadius: 300 horizontalRadius: 100
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0
radio vertical: 300radio vertical: 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.