QGraphicsDropShadowEffect Class
La classe QGraphicsDropShadowEffect permet de créer un effet d'ombre portée. En savoir plus...
| En-tête : | #include <QGraphicsDropShadowEffect> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QGraphicsEffect |
Propriétés
|
Fonctions publiques
| QGraphicsDropShadowEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsDropShadowEffect() |
| qreal | blurRadius() const |
| QColor | color() const |
| QPointF | offset() const |
| qreal | xOffset() const |
| qreal | yOffset() const |
Fonctions publiques réimplémentées
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
Slots publics
| void | setBlurRadius(qreal blurRadius) |
| void | setColor(const QColor &color) |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
| void | setXOffset(qreal dx) |
| void | setYOffset(qreal dy) |
Signaux
| void | blurRadiusChanged(qreal blurRadius) |
| void | colorChanged(const QColor &color) |
| void | offsetChanged(const QPointF &offset) |
Fonctions protégées réimplémentées
| virtual void | draw(QPainter *painter) override |
Description détaillée
Un effet d’ombre portée ajoute une ombre portée à la source. La couleur de l’ombre portée peut être modifiée à l’aide de la fonction setColor(). Le décalage de l’ombre portée peut être modifié à l’aide de la fonction setOffset(), et le rayon de flou de l’ombre portée peut être modifié à l’aide de la fonction setBlurRadius().
Par défaut, l’ombre portée est une ombre gris foncé semi-transparente (QColor(63, 63, 63, 180)), floutée avec un rayon de 1 et décalée de 8 pixels vers le coin inférieur droit. Le décalage de l’ombre portée est spécifié en coordonnées de l’appareil.

Voir également QGraphicsBlurEffect, QGraphicsColorizeEffect et QGraphicsOpacityEffect.
Documentation sur les propriétés
blurRadius : qreal
Cette propriété définit le rayon de flou, en pixels, de l'ombre portée.
Un rayon plus petit donne une ombre plus nette, tandis qu'un rayon plus grand donne une ombre plus floue.
Par défaut, le rayon de flou est de 1 pixel.
Fonctions d'accès :
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
Signal de notification :
| void | blurRadiusChanged(qreal blurRadius) |
Voir également color() et offset().
color : QColor
Cette propriété définit la couleur de l'ombre portée.
Par défaut, la couleur de l'ombre portée est un gris foncé semi-transparent (QColor(63, 63, 63, 180)).
Fonctions d'accès :
| QColor | color() const |
| void | setColor(const QColor &color) |
Signal de notification :
| void | colorChanged(const QColor &color) |
Voir également offset() et blurRadius().
offset : QPointF
Cette propriété définit le décalage de l'ombre en pixels.
Par défaut, le décalage est de 8 pixels vers le coin inférieur droit.
Le décalage est exprimé en coordonnées de l'appareil, ce qui signifie qu'il n'est pas affecté par l'échelle.
Fonctions d'accès :
| QPointF | offset() const |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
Signal de notification :
| void | offsetChanged(const QPointF &offset) |
Voir également xOffset(), yOffset(), blurRadius() et color().
xOffset : qreal
Cette propriété définit le décalage horizontal de l'ombre en pixels.
Par défaut, le décalage horizontal de l'ombre est de 8 pixels.
Fonctions d'accès :
| qreal | xOffset() const |
| void | setXOffset(qreal dx) |
Signal de notification :
| void | offsetChanged(const QPointF &offset) |
Voir également yOffset() et offset().
yOffset : qreal
Cette propriété définit le décalage vertical de l'ombre en pixels.
Par défaut, le décalage vertical de l'ombre est de 8 pixels.
Fonctions d'accès :
| qreal | yOffset() const |
| void | setYOffset(qreal dy) |
Signal de notification :
| void | offsetChanged(const QPointF &offset) |
Documentation des fonctions membres
QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)
Crée une nouvelle instance de `QGraphicsDropShadowEffect`. Le paramètre ` parent ` est transmis au constructeur de ` QGraphicsEffect`.
[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()
Annule l'effet.
[signal] void QGraphicsDropShadowEffect::blurRadiusChanged(qreal blurRadius)
Ce signal est émis chaque fois que le rayon de flou de l'effet change. Le paramètre blurRadius contient le nouveau rayon de flou de l'effet.
Remarque : signalde notification pour la propriété blurRadius.
[override virtual] QRectF QGraphicsDropShadowEffect::boundingRectFor(const QRectF &rect) const
Réimplémente : QGraphicsEffect::boundingRectFor(const QRectF &rect) const.
[signal] void QGraphicsDropShadowEffect::colorChanged(const QColor &color)
Ce signal est émis chaque fois que la couleur de l'effet change. Le paramètre « color » contient la nouvelle couleur de l'effet.
Remarque : signalde notification pour la propriété « color ».
[override virtual protected] void QGraphicsDropShadowEffect::draw(QPainter *painter)
Réimplémente : QGraphicsEffect::draw(QPainter *painter).
[signal] void QGraphicsDropShadowEffect::offsetChanged(const QPointF &offset)
Ce signal est émis chaque fois que le décalage de l'ombre de l'effet change. Le paramètre offset contient le nouveau décalage de l'ombre de l'effet.
© 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.