En esta página

RectangularGlow QML Type

Genera un rectángulo difuminado y coloreado, que da la impresión de que la fuente brilla. Más...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propiedades

Descripción detallada

Este efecto está pensado para tener un buen rendimiento. La forma del resplandor se limita a un rectángulo con un radio de esquina personalizado. Para situaciones en las que se requieran formas personalizadas, considere el efecto Glow.

Efecto aplicado

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

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
    }
}

Documentación de propiedades

cached : bool

Esta propiedad permite almacenar en caché los píxeles de salida del efecto para mejorar el rendimiento del renderizado.

Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.

Por defecto, la propiedad está establecida en false.

color : color

Esta propiedad define el valor de color RGBA que se utiliza para el resplandor.

Por defecto, la propiedad se establece en "white".

Ejemplos de salida con diferentes valores de color

color: #ffffff color: #55ff55 color: #5555ff
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
cornerRadius: 25cornerRadius: 25cornerRadius: 25

cornerRadius : real

Esta propiedad define el radio de las esquinas que se utiliza para dibujar un resplandor con esquinas redondeadas.

El valor oscila entre 0.0 y la mitad de la anchura o altura efectiva del resplandor, la que sea menor. Puede calcularse con: min(width, height) / 2.0 + glowRadius

Por defecto, la propiedad está ligada a la propiedad glowRadius. El resplandor se comporta como si el rectángulo estuviera difuminado al ajustar la propiedad glowRadius.

Ejemplos de salida con diferentes valores de cornerRadius

cornerRadius: 0 cornerRadius: 25 cornerRadius: 50
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #ffffff

glowRadius : real

Esta propiedad define cuántos píxeles fuera del área del elemento son alcanzados por el resplandor.

El valor va de 0.0 (sin brillo) a inf (brillo infinito). Por defecto, la propiedad está establecida en 0.0.

Ejemplos de salida con diferentes valores de glowRadius

glowRadius: 10 glowRadius: 20 glowRadius: 40
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #ffffff
cornerRadius: 25cornerRadius: 25cornerRadius: 25

spread : real

Esta propiedad define cómo de grande es la parte del color del resplandor que se refuerza cerca de los bordes de la fuente.

El valor oscila entre 0.0 (sin aumento de intensidad) y 1.0 (máximo aumento de intensidad). Por defecto, la propiedad está establecida en 0.0.

Ejemplos de salida con diferentes valores de dispersión

dispersión: 0.0 dispersión: 0.5 dispersión: 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.