RectangularGlow QML Type
Génère un rectangle flou et coloré, qui donne l'impression que la source brille. En savoir plus…
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
- cached : bool
- color : color
- cornerRadius : real
- glowRadius : real
- spread : real
Description détaillée
Cet effet est conçu pour offrir de bonnes performances. La forme de la lueur est limitée à un rectangle dont le rayon des coins est personnalisable. Si vous avez besoin de formes personnalisées, envisagez l'eff Glow.
| Effet appliqué |
|---|
|
Exemple
L'exemple suivant montre comment appliquer l'effet.
import QtQuick
import Qt5Compat.GraphicalEffects
Item {
width: 300
height: 300
Rectangle {
id: background
anchors.fill: parent
color: "black"
}
RectangularGlow {
id: effect
anchors.fill: rect
glowRadius: 10
spread: 0.2
color: "white"
cornerRadius: rect.radius + glowRadius
}
Rectangle {
id: rect
color: "black"
anchors.centerIn: parent
width: Math.round(parent.width / 1.5)
height: Math.round(parent.height / 2)
radius: 25
}
}Documentation des 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 contenus dans le 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 ».
color : color
Cette propriété définit la valeur de couleur RGBA utilisée pour la lueur.
Par défaut, cette propriété est définie sur "white".
| Exemples de rendu avec différentes valeurs de couleur | ||
|---|---|---|
|
|
|
| color: #ffffff | color: #55ff55 | color: #5555ff |
| glowRadius: 20 | glowRadius: 20 | glowRadius: 20 |
| spread: 0 | spread: 0 | spread: 0 |
| cornerRadius: 25 | cornerRadius: 25 | cornerRadius: 25 |
cornerRadius : real
Cette propriété définit le rayon des coins utilisé pour dessiner un halo aux coins arrondis.
La valeur est comprise entre 0,0 et la moitié de la largeur ou de la hauteur effective de l'auréole, la plus petite des deux étant retenue. Elle peut être calculée à l'aide de la formule suivante : min(width, height) / 2.0 + glowRadius
Par défaut, cette propriété est liée à la propriété « glowRadius ». Le halo se comporte comme si le rectangle était flou lorsque l'on modifie la propriété « glowRadius ».
| Exemples de rendu avec différentes valeurs de `cornerRadius` | ||
|---|---|---|
|
|
|
| cornerRadius : 0 | cornerRadius : 25 | cornerRadius : 50 |
| glowRadius: 20 | glowRadius: 20 | glowRadius: 20 |
| spread: 0 | spread: 0 | spread: 0 |
| color: #ffffff | color: #ffffff | color: #ffffff |
glowRadius : real
Cette propriété définit le nombre de pixels situés en dehors de la zone de l'élément qui sont touchés par la lueur.
La valeur est comprise entre 0,0 (pas de lueur) et inf (lueur infinie). Par défaut, la propriété est définie sur 0.0.
| Exemples de rendu avec différentes valeurs de glowRadius | ||
|---|---|---|
|
|
|
| glowRadius : 10 | glowRadius : 20 | glowRadius : 40 |
| spread: 0 | spread: 0 | spread: 0 |
| color: #ffffff | color: #ffffff | color: #ffffff |
| cornerRadius: 25 | cornerRadius: 25 | cornerRadius: 25 |
spread : real
Cette propriété définit dans quelle mesure la couleur de la lueur est intensifiée près des bords de la source.
La valeur varie de 0,0 (aucune intensité accrue) à 1,0 (intensité maximale accrue). Par défaut, la propriété est définie sur 0.0.
| Exemples de rendu avec différentes valeurs de diffusion | ||
|---|---|---|
|
|
|
| spread : 0,0 | spread : 0,5 | spread : 1,0 |
| glowRadius: 20 | glowRadius: 20 | glowRadius: 20 |
| color: #ffffff | color: #ffffff | color: #ffffff |
| cornerRadius: 25 | cornerRadius: 25 | cornerRadius: 25 |
© 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.












