En esta página

QGraphicsBlurEffect Class

La clase QGraphicsBlurEffect proporciona un efecto de desenfoque. Más información...

Encabezado: #include <QGraphicsBlurEffect>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QGraphicsEffect

Tipos públicos

enum BlurHint { PerformanceHint, QualityHint, AnimationHint }
flags BlurHints

Propiedades

Funciones públicas

QGraphicsBlurEffect(QObject *parent = nullptr)
virtual ~QGraphicsBlurEffect()
QGraphicsBlurEffect::BlurHints blurHints() const
qreal blurRadius() const

Funciones públicas reimplementadas

virtual QRectF boundingRectFor(const QRectF &rect) const override

Ranuras públicas

void setBlurHints(QGraphicsBlurEffect::BlurHints hints)
void setBlurRadius(qreal blurRadius)

Señales

void blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
void blurRadiusChanged(qreal radius)

Funciones protegidas reimplementadas

virtual void draw(QPainter *painter) override

Descripción detallada

Un efecto de desenfoque difumina la fuente. Este efecto resulta útil para reducir detalles, por ejemplo, cuando la fuente pierde protagonismo y se desea dirigir la atención hacia otros elementos. El nivel de detalle se puede modificar mediante la función ` setBlurRadius()`. Utiliza ` setBlurHints()` para seleccionar los parámetros de desenfoque.

Por defecto, el radio de desenfoque es de 5 píxeles. El radio de desenfoque se especifica en coordenadas del dispositivo.

Efecto de desenfoque en una imagen de un pez

Véase también QGraphicsDropShadowEffect, QGraphicsColorizeEffect y QGraphicsOpacityEffect.

Documentación sobre tipos de miembros

enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints

Esta enumeración describe las posibles opciones que se pueden utilizar para controlar cómo se aplican los efectos de desenfoque. Es posible que estas opciones no surtan efecto en todos los motores de renderizado.

ConstanteValorDescripción
QGraphicsBlurEffect::PerformanceHint0x00Indica que el rendimiento del renderizado es el factor más importante, aunque ello pueda suponer una menor calidad.
QGraphicsBlurEffect::QualityHint0x01Indica que la calidad del renderizado es el factor más importante, a costa, potencialmente, de un menor rendimiento.
QGraphicsBlurEffect::AnimationHint0x02Indica que el radio de desenfoque se va a animar, lo que sugiere que la implementación puede mantener una caché de versiones desenfocadas del elemento de origen. No utilices esta indicación si el elemento de origen va a cambiar dinámicamente.

El tipo `BlurHints` es una definición de tipo (`typedef`) para `QFlags<BlurHint>`. Almacena una combinación OR de valores de `BlurHint`.

Véase también blurHints() y setBlurHints().

Documentación de la propiedad

blurHints : BlurHints

Esta propiedad contiene la indicación de desenfoque del efecto.

Utiliza la indicación « PerformanceHint » para indicar que quieres un desenfoque más rápido, la indicación « QualityHint » para indicar que prefieres un desenfoque de mayor calidad, o la indicación « AnimationHint » cuando quieras animar el radio de desenfoque.

Por defecto, la indicación de desenfoque es « PerformanceHint ».

Funciones de acceso:

QGraphicsBlurEffect::BlurHints blurHints() const
void setBlurHints(QGraphicsBlurEffect::BlurHints hints)

Señal de notificador:

void blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)

blurRadius : qreal

Esta propiedad determina el radio de desenfoque del efecto.

Si se utiliza un radio más pequeño, el resultado es una imagen más nítida, mientras que un radio mayor da lugar a una imagen más difuminada.

Por defecto, el radio de desenfoque es de 5 píxeles.

El radio se expresa en coordenadas del dispositivo, lo que significa que no se ve afectado por la escala.

Funciones de acceso:

qreal blurRadius() const
void setBlurRadius(qreal blurRadius)

Señal de notificador:

void blurRadiusChanged(qreal radius)

Documentación de funciones de miembro

QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)

Crea una nueva instancia de `QGraphicsBlurEffect`. El parámetro ` parent ` se pasa al constructor de ` QGraphicsEffect`.

[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()

Anula el efecto.

[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)

Esta señal se emite cada vez que cambian las indicaciones de desenfoque del efecto. El parámetro « hints » contiene las nuevas indicaciones de desenfoque del efecto.

Nota: Señalde notificación para la propiedad « blurHints ».

[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)

Esta señal se emite cada vez que cambia el radio de desenfoque del efecto. El parámetro « radius » contiene el nuevo radio de desenfoque del efecto.

Nota: Señalde notificación para la propiedad blurRadius.

[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const

Reimplementa: QGraphicsEffect::boundingRectFor(const QRectF &rect) const.

[override virtual protected] void QGraphicsBlurEffect::draw(QPainter *painter)

Reimplementa: QGraphicsEffect::draw(QPainter *painter).

© 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.