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
Propiedades
- blurHints : BlurHints
- blurRadius : qreal
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.

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.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | Indica que el rendimiento del renderizado es el factor más importante, aunque ello pueda suponer una menor calidad. |
QGraphicsBlurEffect::QualityHint | 0x01 | Indica que la calidad del renderizado es el factor más importante, a costa, potencialmente, de un menor rendimiento. |
QGraphicsBlurEffect::AnimationHint | 0x02 | Indica 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.