QGraphicsBlurEffect Class
La clase QGraphicsBlurEffect proporciona un efecto de desenfoque. Más...
| Cabecera: | #include <QGraphicsBlurEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 desenfoca la fuente. Este efecto es útil para reducir detalles, como cuando la fuente pierde el foco y se quiere llamar la atención sobre otros elementos. El nivel de detalle puede modificarse mediante la función setBlurRadius(). Utilice setBlurHints() para elegir los toques de desenfoque.
Por defecto, el radio de desenfoque es de 5 píxeles. El radio de desenfoque se especifica en coordenadas de dispositivo.
Véase también QGraphicsDropShadowEffect, QGraphicsColorizeEffect, y QGraphicsOpacityEffect.
Documentación de tipos de miembros
enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints
Este enum describe las posibles sugerencias que pueden utilizarse para controlar cómo se aplican los efectos de desenfoque. Las sugerencias pueden no tener efecto en todos los motores de pintura.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | Indica que el rendimiento de renderizado es el factor más importante, a costa de una menor calidad. |
QGraphicsBlurEffect::QualityHint | 0x01 | Indica que la calidad de renderizado es el factor más importante, con el coste potencial de un menor rendimiento. |
QGraphicsBlurEffect::AnimationHint | 0x02 | Indica que el radio de desenfoque va a ser animado, dando a entender que la implementación puede mantener una caché de versiones desenfocadas de la fuente. No utilice esta sugerencia si la fuente va a cambiar dinámicamente. |
El tipo BlurHints es un typedef para QFlags<BlurHint>. Almacena una combinación OR de valores BlurHint.
Véase también blurHints() y setBlurHints().
Documentación de propiedades
blurHints : BlurHints
Esta propiedad contiene la sugerencia de desenfoque del efecto.
Utilice la sugerencia PerformanceHint para decir que desea un desenfoque más rápido, la sugerencia QualityHint para decir que prefiere un desenfoque de mayor calidad, o la sugerencia AnimationHint cuando desee animar el radio del desenfoque.
Por defecto, la sugerencia de desenfoque es PerformanceHint.
Funciones de acceso:
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
Señal de aviso:
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
blurRadius : qreal
Esta propiedad contiene el radio de desenfoque del efecto.
Con un radio menor se consigue un aspecto más nítido, mientras que con un radio mayor se consigue un aspecto más borroso.
Por defecto, el radio de desenfoque es de 5 píxeles.
El radio se da en coordenadas de dispositivo, lo que significa que no se ve afectado por la escala.
Funciones de acceso:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
Señal notificadora:
| void | blurRadiusChanged(qreal radius) |
Documentación de funciones miembro
QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)
Construye una nueva instancia de QGraphicsBlurEffect. El parámetro parent se pasa al constructor de QGraphicsEffect.
[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()
Destruye el efecto.
[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
Esta señal se emite cada vez que cambian las sugerencias de desenfoque del efecto. El parámetro hints contiene las nuevas sugerencias de desenfoque del efecto.
Nota: Señal notificadora 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ñal notificadora 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.
