Sur cette page

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:

Item

Propriétés

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é

Effet lumineux rectangulaire blanc

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

Lueur blanche

Lueur verte

Lueur bleue

color: #ffffff color: #55ff55 color: #5555ff
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
cornerRadius: 25cornerRadius: 25cornerRadius: 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`

Lueur avec rayon de courbure de 0

Lueur avec un rayon de courbure de 25

Lueur avec un rayon de courbure de 50

cornerRadius : 0 cornerRadius : 25 cornerRadius : 50
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #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

Lueur de rayon 10

Lueur de rayon 20

Lueur de rayon 40

glowRadius : 10 glowRadius : 20 glowRadius : 40
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #ffffff
cornerRadius: 25cornerRadius: 25cornerRadius: 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

Lueur avec écart de 0,0

Lueur avec écart de 0,5

Glow avec spread 1.0

spread : 0,0 spread : 0,5 spread : 1,0
glowRadius: 20glowRadius: 20glowRadius: 20
color: #ffffffcolor: #ffffffcolor: #ffffff
cornerRadius: 25cornerRadius: 25cornerRadius: 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.