Sur cette page

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:

Item

Propriétés

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