Sur cette page

QGraphicsDropShadowEffect Class

La classe QGraphicsDropShadowEffect fournit un effet d'ombre portée. Plus d'informations...

En-tête : #include <QGraphicsDropShadowEffect>
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

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

Emplacements 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 rend la source avec une ombre portée. 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 semi-transparente gris foncé (QColor(63, 63, 63, 180)), floue avec un rayon de 1 à un décalage de 8 pixels vers le bas à droite. Le décalage de l'ombre portée est spécifié en coordonnées de périphérique.

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.

L'utilisation d'un rayon plus petit donne une ombre plus nette, tandis que l'utilisation d'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 aussi color() et offset().

color : QColor

Cette propriété définit la couleur de l'ombre portée.

Par défaut, la couleur de la goutte est un gris foncé semi-transparent (QColor(63, 63, 63, 180)).

Fonctions d'accès :

QColor color() const
void setColor(const QColor &color)

Signal Notifier :

void colorChanged(const QColor &color)

Voir aussi 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 bas à droite.

Le décalage est donné en coordonnées de périphérique, 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 Notifier :

void offsetChanged(const QPointF &offset)

Voir aussi xOffset(), yOffset(), blurRadius() et color().

xOffset : qreal

Cette propriété indique le décalage de l'ombre horizontale en pixels.

Par défaut, le décalage de l'ombre horizontale est de 8 pixels.

Fonctions d'accès :

qreal xOffset() const
void setXOffset(qreal dx)

Signal Notifier :

void offsetChanged(const QPointF &offset)

Voir aussi yOffset() et offset().

yOffset : qreal

Cette propriété contient le décalage de l'ombre verticale en pixels.

Par défaut, le décalage de l'ombre verticale est de 8 pixels.

Fonctions d'accès :

qreal yOffset() const
void setYOffset(qreal dy)

Signal Notifier :

void offsetChanged(const QPointF &offset)

Voir également xOffset() et offset().

Documentation des fonctions membres

QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)

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

[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()

Détruit l'effet.

[signal] void QGraphicsDropShadowEffect::blurRadiusChanged(qreal blurRadius)

Ce signal est émis lorsque le rayon de flou de l'effet change. Le paramètre blurRadius contient le nouveau rayon de flou de l'effet.

Remarque : signal de 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 lorsque la couleur de l'effet change. Le paramètre color contient la nouvelle couleur de l'effet.

Note : Signal de 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 lorsque 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 : signal de 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.