Gradient QML Type
Define un relleno degradado. Más...
| Import Statement: | import QtQuick |
| Inherited By: | ConicalGradient, LinearGradient, RadialGradient, and ShapeGradient |
Propiedades
- orientation : enumeration
- stops : list<GradientStop>
Descripción detallada
Un degradado se define mediante dos o más colores, que se mezclarán de forma fluida.
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 su propiedad « position »; su color se define mediante su propiedad « color ».
Un degradado sin puntos de parada se representa como un relleno blanco liso.
Ten en cuenta que este elemento no es una representación visual de un degradado. Para mostrar un degradado, utiliza un elemento visual (como Rectangle) que admita el uso de degradados.
Ejemplo de uso

El siguiente ejemplo declara un elemento « Rectangle » con un degradado que comienza en rojo, se funde con el amarillo a un tercio de la altura del rectángulo y termina en verde:
Rectangle {
width: 100; height: 100
gradient: Gradient {
GradientStop { position: 0.0; color: "red" }
GradientStop { position: 0.33; color: "yellow" }
GradientStop { position: 1.0; color: "green" }
}
}Rendimiento y limitaciones
El cálculo de degradados puede suponer una carga computacional elevada en comparación con el uso de rellenos de color sólido o imágenes. Se recomienda utilizar degradados para elementos estáticos en una interfaz de usuario.
Desde Qt 5.12, se pueden aplicar degradados lineales verticales y horizontales a los elementos. Si necesitas aplicar degradados en ángulo, puedes aplicar una combinación de rotación y recorte a los elementos correspondientes. Como alternativa, considera utilizar ` QtQuick.Shapes::LinearGradient` o `QtGraphicalEffects::LinearGradient`. Todos estos enfoques pueden suponer requisitos de rendimiento adicionales para tu aplicación.
El uso de animaciones que incluyan paradas de degradado puede no dar el resultado deseado. Una forma alternativa de animar los degradados es utilizar imágenes pregeneradas o dibujos SVG que contengan degradados.
Véase también GradientStop.
Documentación de propiedades
orientation : enumeration
Establece esta propiedad para definir la dirección del degradado.
| Constante | Descripción |
|---|---|
Gradient.Vertical | un degradado vertical |
Gradient.Horizontal | un degradado horizontal |
El valor predeterminado es Gradient.Vertical.
stops : list<GradientStop> [default read-only]
Esta propiedad contiene las paradas del degradado que describen dicho degradado.
Por defecto, esta propiedad contiene una lista vacía.
Para establecer los puntos de parada del degradado, defínelos como elementos secundarios del degradado.
© 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.