ConicalGradient QML Type
Dessine un gradient conique. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
- angle : real
- cached : bool
- gradient : Gradient
- horizontalOffset : real
- source : variant
- verticalOffset : real
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 commencent à l'angle spécifié et se terminent à 360 degrés de la valeur d'angle la plus grande.
| Effet appliqué |
|---|
|
Exemple d'application
L'exemple suivant montre comment appliquer l'effet.
import QtQuick import Qt5Compat.GraphicalEffects Item { width: 300 height: 300 ConicalGradient { anchors.fill: parent angle: 0.0 gradient: Gradient { GradientStop { position: 0.0; color: "white" } GradientStop { position: 1.0; color: "black" } } } }
Documentation sur les propriétés
angle : real
Cette propriété définit l'angle de départ où la couleur à la position de gradient de 0,0 est rendue. Les couleurs situées à des valeurs de position plus élevées sont rendues dans des valeurs d'angle plus importantes et mélangées de manière transparente. Les valeurs d'angle augmentent dans le sens des aiguilles d'une montre.
| Exemples de résultats avec différentes valeurs d'angle | ||
|---|---|---|
|
|
|
| angle : 0 | angle : 45 | angle : 185 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
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.
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éfinissant une position sur le dégradé (de 0,0 à 1,0) et une couleur. La position de chaque GradientStop est définie par la propriété position. 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"
}
} |
| angle: 0 | angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
horizontalOffset : real
Les propriétés horizontalOffset et verticalOffset définissent le décalage en pixels du point central du dégradé par rapport au centre de l'élément.
La valeur est comprise entre -inf et inf. Par défaut, les propriétés sont définies sur 0.
| Exemples de résultats avec différentes valeurs de horizontalOffset | ||
|---|---|---|
|
|
|
| décalage horizontal : -50 | décalage horizontal : 0 | horizontalOffset : 50 |
| angle: 0 | angle: 0 | angle: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
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 : |
| angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 |
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.
verticalOffset : real
Les propriétés horizontalOffset et verticalOffset définissent le décalage en pixels du point central du dégradé par rapport au centre de l'élément.
La valeur est comprise entre -inf et inf. Par défaut, les propriétés sont définies sur 0.
| Exemples de résultats avec différentes valeurs de horizontalOffset | ||
|---|---|---|
|
|
|
| horizontalOffset: -50 | horizontalOffset: 0 | horizontalOffset: 50 |
| angle: 0 | angle: 0 | angle: 0 |
| décalage vertical : 0 | décalage vertical : 0 | décalage vertical : 0 |
© 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.











