Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QGraphicsDropShadowEffect Class

Die Klasse „QGraphicsDropShadowEffect“ bietet einen Schlagschatteneffekt. Mehr...

Header: #include <QGraphicsDropShadowEffect>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Erbt von: QGraphicsEffect

Eigenschaften

Öffentliche Funktionen

QGraphicsDropShadowEffect(QObject *parent = nullptr)
virtual ~QGraphicsDropShadowEffect()
qreal blurRadius() const
QColor color() const
QPointF offset() const
qreal xOffset() const
qreal yOffset() const

Neu implementierte öffentliche Funktionen

virtual QRectF boundingRectFor(const QRectF &rect) const override

Öffentliche Slots

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)

Signale

void blurRadiusChanged(qreal blurRadius)
void colorChanged(const QColor &color)
void offsetChanged(const QPointF &offset)

Neu implementierte geschützte Funktionen

virtual void draw(QPainter *painter) override

Ausführliche Beschreibung

Ein Schlagschatteneffekt rendert die Quelle mit einem Schlagschatten. Die Farbe des Schlagschattens kann mit der Funktion ` setColor()` geändert werden. Der Versatz des Schlagschattens kann mit der Funktion ` setOffset()` angepasst werden, und der Unschärferadius des Schlagschattens lässt sich mit der Funktion ` setBlurRadius()` ändern.

Standardmäßig ist der Schlagschatten ein halbtransparenter dunkelgrauer (QColor(63, 63, 63, 180)) Schatten, der mit einem Radius von 1 und einem Versatz von 8 Pixeln nach rechts unten weichgezeichnet ist. Der Versatz des Schlagschattens wird in Gerätekoordinaten angegeben.

Schlagschatteneffekt auf einem Bild eines Fisches

Siehe auch QGraphicsBlurEffect, QGraphicsColorizeEffect und QGraphicsOpacityEffect.

Eigenschaftsdokumentation

blurRadius : qreal

Diese Eigenschaft legt den Unschärferadius des Schlagschattens in Pixeln fest.

Ein kleinerer Radius führt zu einem schärferen Schatten, während ein größerer Radius einen stärker unscharfen Schatten erzeugt.

Standardmäßig beträgt der Unschärferadius 1 Pixel.

Zugriffsfunktionen:

qreal blurRadius() const
void setBlurRadius(qreal blurRadius)

Benachrichtigungssignal:

void blurRadiusChanged(qreal blurRadius)

Siehe auch „ color()“ und „ offset()“.

color : QColor

Diese Eigenschaft legt die Farbe des Schlagschattens fest.

Standardmäßig ist die Farbe des Schlagschattens ein halbtransparentes Dunkelgrau (QColor(63, 63, 63, 180)).

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void colorChanged(const QColor &color)

Siehe auch offset() und blurRadius().

offset : QPointF

Diese Eigenschaft gibt den Schattenversatz in Pixeln an.

Standardmäßig beträgt der Versatz 8 Pixel in Richtung rechts unten.

Der Versatz wird in Gerätekordinaten angegeben, was bedeutet, dass er von der Skalierung unbeeinflusst bleibt.

Zugriffsfunktionen:

QPointF offset() const
void setOffset(const QPointF &ofs)
void setOffset(qreal dx, qreal dy)
void setOffset(qreal d)

Notifier-Signal:

void offsetChanged(const QPointF &offset)

Siehe auch „ xOffset()“, „ yOffset()“, „ blurRadius()“ und „ color()“.

xOffset : qreal

Diese Eigenschaft gibt den horizontalen Schattenversatz in Pixeln an.

Standardmäßig beträgt der horizontale Schattenversatz 8 Pixel.

Zugriffsfunktionen:

qreal xOffset() const
void setXOffset(qreal dx)

Benachrichtigungssignal:

void offsetChanged(const QPointF &offset)

Siehe auch „ yOffset()“ und „ offset()“.

yOffset : qreal

Diese Eigenschaft gibt den vertikalen Schattenversatz in Pixeln an.

Standardmäßig beträgt der vertikale Schattenversatz 8 Pixel.

Zugriffsfunktionen:

qreal yOffset() const
void setYOffset(qreal dy)

Benachrichtigungssignal:

void offsetChanged(const QPointF &offset)

Siehe auch „ xOffset()“ und „ offset()“.

Dokumentation der Mitgliedsfunktionen

QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)

Erstellt eine neue Instanz von `QGraphicsDropShadowEffect`. Der Parameter ` parent ` wird an den Konstruktor von ` QGraphicsEffect` übergeben.

[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()

Hebt den Effekt auf.

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

Dieses Signal wird immer dann ausgelöst, wenn sich der Unschärferadius des Effekts ändert. Der Parameter „ blurRadius “ enthält den neuen Unschärferadius des Effekts.

Hinweis: Notifier -Signal für die Eigenschaft „ blurRadius “.

[override virtual] QRectF QGraphicsDropShadowEffect::boundingRectFor(const QRectF &rect) const

Implementiert: ` QGraphicsEffect::boundingRectFor(const QRectF &rect) const`.

[signal] void QGraphicsDropShadowEffect::colorChanged(const QColor &color)

Dieses Signal wird immer dann ausgegeben, wenn sich die Farbe des Effekts ändert. Der Parameter „ color “ enthält die neue Farbe des Effekts.

Hinweis: Notifier -Signal für die Eigenschaft „ color “.

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

Implementiert erneut: ` QGraphicsEffect::draw` (`QPainter *painter`).

[signal] void QGraphicsDropShadowEffect::offsetChanged(const QPointF &offset)

Dieses Signal wird immer dann ausgelöst, wenn sich der Schattenversatz des Effekts ändert. Der Parameter „ offset “ enthält den neuen Schattenversatz des Effekts.

Hinweis: Notifier -Signal für die Eigenschaften „ offset “, „ xOffset “ und „ 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.