Sur cette page

QGraphicsOpacityEffect Class

La classe QGraphicsOpacityEffect fournit un effet d'opacité. Plus d'informations...

En-tête : #include <QGraphicsOpacityEffect>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : QGraphicsEffect

Propriétés

Fonctions publiques

QGraphicsOpacityEffect(QObject *parent = nullptr)
virtual ~QGraphicsOpacityEffect()
qreal opacity() const
QBrush opacityMask() const

Emplacements publics

void setOpacity(qreal opacity)
void setOpacityMask(const QBrush &mask)

Signaux

void opacityChanged(qreal opacity)
void opacityMaskChanged(const QBrush &mask)

Fonctions protégées réimplémentées

virtual void draw(QPainter *painter) override

Description détaillée

Un effet d'opacité rend la source avec une opacité. Cet effet est utile pour rendre la source semi-transparente, comme dans le cas d'une séquence de fondu-enchaîné. L'opacité peut être modifiée à l'aide de la fonction setOpacity().

Par défaut, l'opacité est de 0,7.

Effet d'opacité sur l'image d'un poisson

Voir également QGraphicsDropShadowEffect, QGraphicsBlurEffect, et QGraphicsColorizeEffect.

Documentation sur les propriétés

opacity : qreal

Cette propriété définit l'opacité de l'effet.

La valeur doit être comprise entre 0,0 et 1,0, où 0,0 correspond à une transparence totale et 1,0 à une opacité totale.

Par défaut, l'opacité est de 0,7.

Fonctions d'accès :

qreal opacity() const
void setOpacity(qreal opacity)

Signal de notification :

void opacityChanged(qreal opacity)

Voir aussi setOpacityMask().

opacityMask : QBrush

Cette propriété contient le masque d'opacité de l'effet.

Un masque d'opacité permet d'appliquer l'opacité à des parties d'un élément.

Par exemple, il n'y a pas de masque d'opacité par défaut :

...
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);
...

Il n'y a pas de masque d'opacité par défaut.

Fonctions d'accès :

QBrush opacityMask() const
void setOpacityMask(const QBrush &mask)

Signal de notification :

void opacityMaskChanged(const QBrush &mask)

Voir aussi setOpacity().

Documentation des fonctions membres

QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)

Construit une nouvelle instance de QGraphicsOpacityEffect. Le paramètre parent est transmis au constructeur de QGraphicsEffect.

[virtual noexcept] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()

Détruit l'effet.

[override virtual protected] void QGraphicsOpacityEffect::draw(QPainter *painter)

Réimplémente : QGraphicsEffect::draw(QPainter *painter).

[signal] void QGraphicsOpacityEffect::opacityChanged(qreal opacity)

Ce signal est émis lorsque l'opacité de l'effet change. Le paramètre opacity contient la nouvelle opacité de l'effet.

Note : Signal de notification pour la propriété opacity.

[signal] void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)

Ce signal est émis lorsque le masque d'opacité de l'effet change. Le paramètre mask contient le nouveau masque d'opacité de l'effet.

Note : Signal de notification pour la propriété 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.