Sur cette page

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.

Effet d'ombre portée sur l'image d'un poisson

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)

Voir également xOffset() et 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.

Remarque : signalde notification pour les propriétés offset, xOffset et yOffset.

© 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.