LinearGradient QML Type
Dessine un dégradé linéaire. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
Description détaillée
Un dégradé est défini par deux couleurs ou plus, qui sont mélangées de manière transparente. Les couleurs partent du point de départ donné et se terminent au point d'arrivée donné.
| Effet appliqué |
|---|
|
Exemple d'application
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" } } } }
Propriété Documentation
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 une mémoire tampon 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 à une position de gradient de 1,0 est rendue. Les couleurs situées à des positions inférieures sont rendues de manière linéaire vers le point de départ. Le point est donné en pixels et la valeur par défaut est Qt.point(0, height). En définissant les valeurs par défaut pour start et la fin, on obtient un dégradé linéaire sur toute la hauteur de l'axe des ordonnées.
gradient : Gradient |
Un dégradé est défini par deux couleurs ou plus, qui sont mélangées de manière transparente. Les couleurs sont spécifiées sous la forme d'un ensemble d'éléments enfants GradientStop, chacun d'eux définissant une position sur le dégradé entre 0,0 et 1,0 et une couleur. La position de chaque GradientStop est définie par la propriété position et la couleur est définie par la propriété color.
| Exemples de sortie avec différentes valeurs de dégradé | ||
|---|---|---|
|
|
|
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)
}
} | gradient :Gradient {
GradientStop {
position: 0.0
color: "#F0F0F0"
}
GradientStop {
position: 0.5
color: "#000000"
}
GradientStop {
position: 1.0
color: "#F0F0F0"
}
} | gradient :Gradient {
GradientStop {
position: 0.0
color: "#00000000"
}
GradientStop {
position: 1.0
color: "#FF000000"
}
} |
| start: Qt.point(0, 0) | start: Qt.point(0, 0) | start: Qt.point(0, 0) |
| end: Qt.point(300, 300) | end: Qt.point(300, 300) | end: Qt.point(300, 300) |
source : variant |
Cette propriété définit l'élément qui va être rempli avec un dégradé. L'élément source est rendu dans un tampon de pixels intermédiaire et les valeurs alpha du résultat sont utilisées pour déterminer la visibilité des pixels du dégradé dans l'affichage. La valeur par défaut de la source est indéfinie et, dans ce cas, toute la zone d'effet est remplie de dégradé.
| Exemples de résultats avec différentes valeurs de source | ||
|---|---|---|
|
| |
| source : undefined | source : Image { source : images/butterfly.png } | |
| start: Qt.point(0, 0) | start: Qt.point(0, 0) | |
| end: Qt.point(300, 300) | end: Qt.point(300, 300) |
Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant la source sur le parent de l'effet.
start : variant |
Cette propriété définit le point de départ du rendu de la couleur à une position de gradient de 0,0. Les couleurs situées à des positions plus élevées sont rendues de manière linéaire vers le point final. Le point est donné en pixels et la valeur par défaut est Qt.point(0, 0). En définissant les valeurs par défaut pour le début et end, on obtient un dégradé linéaire sur toute la hauteur de l'axe des ordonnées.
© 2025 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.











