RectangularGlow QML Type
Génère un rectangle flou et colorisé, qui donne l'impression que la source est lumineuse. Plus d'informations...
| 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 l'éclat est limitée à un rectangle avec un rayon d'angle personnalisé. Pour les situations où des formes personnalisées sont nécessaires, envisagez l'effet Glow.
| Effet appliqué |
|---|
|
Exemple d'application
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 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 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.
color : color
Cette propriété définit la valeur de la couleur RGBA utilisée pour la lueur.
Par défaut, la propriété est définie sur "white".
| Exemples de sortie avec différentes valeurs de couleur | ||
|---|---|---|
|
|
|
| couleur : #ffffff | couleur : #55ff55 | couleur : #55ffff #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 d'angle utilisé pour dessiner une lueur aux angles arrondis.
La valeur est comprise entre 0,0 et la moitié de la largeur ou de la hauteur effective de la lueur, la plus petite étant retenue. Cette valeur peut être calculée avec : min(width, height) / 2.0 + glowRadius
Par défaut, la propriété est liée à la propriété glowRadius. La lueur se comporte comme si le rectangle était flou lorsque l'on ajuste la propriété glowRadius.
| Exemples de résultats avec différentes valeurs de cornerRadius | ||
|---|---|---|
|
|
|
| angleRadius : 0 | angleRadius : 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 à l'extérieur de la zone de l'élément qui sont atteints par la lueur.
La valeur est comprise entre 0,0 (aucune lueur) et inf (lueur infinie). Par défaut, la propriété est définie sur 0.0.
| Exemples de sortie 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 l'ampleur du renforcement de la couleur de l'éclat près des bords de la source.
La valeur est comprise entre 0,0 (aucune augmentation de la force) et 1,0 (augmentation maximale de la force). Par défaut, la propriété est définie sur 0.0.
| Exemples de sortie avec différentes valeurs d'étalement | ||
|---|---|---|
|
|
|
| écart : 0,0 | écart : 0,5 | écart : 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.












