En esta página

RectangularGlow QML Type

Genera un rectángulo desenfocado y coloreado, lo 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 ofrecer un buen rendimiento. La forma del resplandor se limita a un rectángulo con un radio de esquina personalizado. En los casos en los que se requieran formas personalizadas, se recomienda utilizar el efect Glow.

Efecto aplicado

Efecto de resplandor rectangular blanco

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 modifican las propiedades de la fuente o del efecto, es necesario actualizar los píxeles de la caché. El consumo de memoria aumenta, ya que se requiere un búfer de memoria adicional para almacenar la salida del efecto.

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

Por defecto, la propiedad está configurada como « false ».

color : color

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

Por defecto, la propiedad está establecida en "white".

Ejemplos de resultado con diferentes valores de color

Resplandor blanco

Resplandor verde

Resplandor azul

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 del ancho o la altura efectiva del resplandor, lo que sea menor. Esto se puede calcular con: min(width, height) / 2.0 + glowRadius

Por defecto, la propiedad está vinculada a la propiedad « glowRadius ». El resplandor se comporta como si el rectángulo estuviera desenfocado al ajustar la propiedad « glowRadius ».

Ejemplos de resultados con diferentes valores de cornerRadius

Resplandor con radio de esquina 0

Resplandor con un radio de esquina de 25

Resplandor con radio de esquina de 50

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

glowRadius : real

Esta propiedad define a cuántos píxeles fuera del área del elemento llega el resplandor.

El valor oscila entre 0,0 (sin resplandor) e inf (resplandor infinito). Por defecto, la propiedad está establecida en 0.0.

Ejemplos de resultados con diferentes valores de glowRadius

Resplandor con radio 10

Resplandor con radio 20

Resplandor con radio 40

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

spread : real

Esta propiedad define en qué medida se intensifica el color del resplandor cerca de los bordes de la fuente.

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

Ejemplos de resultados con diferentes valores de extensión

Brillo con dispersión 0,0

Resplandor con dispersión de 0,5

Brillo con extensión 1.0

difusión: 0,0 difusión: 0,5 difusió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.