En esta página

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

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.

Efecto de opacidad en una imagen de un pez

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.