En esta página

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

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.

Efecto de opacidad en la imagen de un pez

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.