QGraphicsOpacityEffect Class
La clase QGraphicsOpacityEffect proporciona un efecto de opacidad. Más...
| Cabecera: | #include <QGraphicsOpacityEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QGraphicsEffect |
Propiedades
- opacity : qreal
- opacityMask : QBrush
Funciones públicas
| QGraphicsOpacityEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsOpacityEffect() |
| qreal | opacity() const |
| QBrush | opacityMask() const |
Ranuras públicas
| void | setOpacity(qreal opacity) |
| void | setOpacityMask(const QBrush &mask) |
Señales
| void | opacityChanged(qreal opacity) |
| void | opacityMaskChanged(const QBrush &mask) |
Funciones protegidas reimplementadas
| virtual void | draw(QPainter *painter) override |
Descripción detallada
Un efecto de opacidad renderiza la fuente con una opacidad. Este efecto es útil para hacer la fuente semitransparente, similar a una secuencia de fundido de entrada/salida. La opacidad puede modificarse mediante la función setOpacity().
Por defecto, la opacidad es 0,7.

Véase también QGraphicsDropShadowEffect, QGraphicsBlurEffect, y QGraphicsColorizeEffect.
Documentación de propiedades
opacity : qreal
Esta propiedad contiene la opacidad del efecto.
El valor debe estar en el rango de 0.0 a 1.0, donde 0.0 es totalmente transparente y 1.0 es totalmente opaco.
Por defecto, la opacidad es 0.7.
Funciones de acceso:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Señal notificadora:
| void | opacityChanged(qreal opacity) |
Véase también setOpacityMask().
opacityMask : QBrush
Esta propiedad contiene la máscara de opacidad del efecto.
Una máscara de opacidad permite aplicar opacidad a partes de un elemento.
Por ejemplo:
... QLinearGradient alphaGradient(rect.topLeft(), rect.bottomLeft()); alphaGradient.setColorAt(0.0, Qt::transparent); alphaGradient.setColorAt(0.5, Qt::black); alphaGradient.setColorAt(1.0, Qt::transparent); QGraphicsOpacityEffect *effect = new QGraphicsOpacityEffect; effect->setOpacityMask(alphaGradient); ...
Por defecto no hay máscara de opacidad.
Funciones de acceso:
| QBrush | opacityMask() const |
| void | setOpacityMask(const QBrush &mask) |
Señal del notificador:
| void | opacityMaskChanged(const QBrush &mask) |
Véase también setOpacity().
Documentación de las funciones miembro
QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)
Construye una nueva instancia de QGraphicsOpacityEffect. El parámetro parent se pasa al constructor de QGraphicsEffect.
[virtual noexcept] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()
Destruye el efecto.
[override virtual protected] void QGraphicsOpacityEffect::draw(QPainter *painter)
Reimplementa: QGraphicsEffect::draw(QPainter *painter).
[signal] void QGraphicsOpacityEffect::opacityChanged(qreal opacity)
Esta señal se emite cada vez que cambia la opacidad del efecto. El parámetro opacity contiene la nueva opacidad del efecto.
Nota: Señal notificadora para la propiedad opacity.
[signal] void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)
Esta señal se emite cada vez que cambia la máscara de opacidad del efecto. El parámetro mask contiene la nueva máscara de opacidad del efecto.
Nota: Señal notificadora para la propiedad opacityMask.
© 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.