Gradient QML Type

Define un relleno de degradado. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• orientation : enumeration
• stops : list<GradientStop>

Descripción detallada

Un degradado está definido por dos o más colores, que se mezclarán 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 gradiente de 0.0 a 1.0 y un color. La posición de cada GradientStop se define estableciendo su propiedad position; su color se define utilizando su propiedad color.

Un degradado sin ningún tope de degradado se representa como un relleno blanco sólido.

Tenga en cuenta que este elemento no es una representación visual de un degradado. Para mostrar un degradado, utilice 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 mezcla con 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 resultar caro en comparación con el uso de rellenos de color sólido o imágenes. Considere el uso de degradados para elementos estáticos en una interfaz de usuario.

Desde Qt 5.12, se pueden aplicar gradientes lineales verticales y horizontales a los elementos. Si necesita aplicar degradados angulares, puede aplicar una combinación de rotación y recorte a los elementos pertinentes. Alternativamente, considere usar QtQuick.Shapes::LinearGradient o QtGraphicalEffects::LinearGradient. Todos estos enfoques pueden introducir requisitos de rendimiento adicionales para su aplicación.

El uso de animaciones que impliquen paradas de gradiente puede no dar el resultado deseado. Una forma alternativa de animar degradados es utilizar imágenes pregeneradas o dibujos SVG que contengan degradados.

Véase también GradientStop.

Documentación de propiedades

orientation : enumeration

Establezca esta propiedad para definir la dirección del gradiente.

El valor por defecto es Gradient.Vertical.

stops : list<GradientStop> [default read-only]

Esta propiedad contiene las paradas de gradiente que describen el gradiente.

Por defecto, esta propiedad contiene una lista vacía.

Para establecer los topes de degradado, defínalos como hijos de Gradiente.