QGraphicsOpacityEffect Class
La clase QGraphicsOpacityEffect proporciona un efecto de opacidad. Más información...
| Encabezado: | #include <QGraphicsOpacityEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | 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 muestra el contenido con opacidad. Este efecto resulta útil para hacer que el contenido sea semitransparente, de forma similar a una secuencia de aparición y desaparición progresivas. La opacidad se puede modificar mediante la función setOpacity().
Por defecto, la opacidad es 0,7.

Véase también QGraphicsDropShadowEffect, QGraphicsBlurEffect y QGraphicsColorizeEffect.
Documentación de la propiedad
opacity : qreal
Esta propiedad determina la opacidad del efecto.
El valor debe estar comprendido entre 0,0 y 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 de notificación:
| 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 te permite aplicar opacidad a determinadas 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 ninguna máscara de opacidad.
Funciones de acceso:
| QBrush | opacityMask() const |
| void | setOpacityMask(const QBrush &mask) |
Señal de notificación:
| void | opacityMaskChanged(const QBrush &mask) |
Véase también setOpacity().
Documentación de funciones de miembro
QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)
Crea una nueva instancia de `QGraphicsOpacityEffect`. El parámetro ` parent ` se pasa al constructor de ` QGraphicsEffect`.
[virtual noexcept] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()
Anula 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ñalde notificación 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ñalde notificación 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.