LinearGradient QML Type

Dessine un dégradé linéaire. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• cached : bool
• end : variant
• gradient : Gradient
• source : variant
• start : variant

Description détaillée

Un dégradé est défini par deux couleurs ou plus, qui se fondent harmonieusement les unes dans les autres. Les couleurs partent d'un point de départ donné et se terminent à un point d'arrivée donné.

Exemple

L'exemple suivant montre comment appliquer l'effet.

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" }
        }
    }
}

Documentation sur les propriétés

cached : bool

Cette propriété permet de mettre en cache les pixels de sortie de l'effet afin d'améliorer les performances de rendu.

Chaque fois que les propriétés de la source ou de l'effet sont modifiées, les pixels du cache doivent être mis à jour. La consommation de mémoire augmente, car un tampon de mémoire supplémentaire est nécessaire pour stocker la sortie de l'effet.

Il est recommandé de désactiver le cache lorsque les propriétés de la source ou de l’effet sont animées.

Par défaut, la propriété est définie sur « false ».

end : variant

Cette propriété définit le point final où la couleur correspondant à la position 1,0 du dégradé est affichée. Les couleurs correspondant à des valeurs de position inférieures sont affichées de manière linéaire en direction du point de départ. Ce point est exprimé en pixels et la valeur par défaut est Qt.point(0, height). La définition des valeurs par défaut pour les paramètres « start » et « end » donne lieu à un dégradé linéaire sur toute la hauteur de l'axe y.

gradient : Gradient

Un dégradé est défini par deux couleurs ou plus, qui s'enchaînent de manière homogène. Les couleurs sont spécifiées sous la forme d'un ensemble d'éléments enfants de type « GradientStop », dont chacun définit une position sur le dégradé comprise entre 0,0 et 1,0 ainsi qu'une couleur. La position de chaque élément « GradientStop » est définie par la propriété « position », et la couleur par la propriété « color ».

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)
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#F0F0F0"
  }
  GradientStop {
    position: 0.5
    color: "#000000"
  }
  GradientStop {
    position: 1.0
    color: "#F0F0F0"
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}

source : variant

Cette propriété définit l'élément qui sera rempli par un dégradé. L'élément source est rendu dans un tampon de pixels intermédiaire et les valeurs d'opacité issues du résultat sont utilisées pour déterminer la visibilité des pixels du dégradé à l'écran. La valeur par défaut de « source » n'est pas définie ; dans ce cas, toute la zone de l'effet est remplie par le dégradé.

start : variant

Cette propriété définit le point de départ où la couleur correspondant à la position 0,0 du dégradé est affichée. Les couleurs situées à des positions supérieures sont affichées de manière linéaire jusqu'au point final. Ce point est exprimé en pixels et la valeur par défaut est Qt.point(0, 0). La définition des valeurs par défaut pour les paramètres start et end donne lieu à un dégradé linéaire sur toute la hauteur de l'axe y.