QGraphicsDropShadowEffect Class

Die Klasse QGraphicsDropShadowEffect bietet einen Schlagschatteneffekt. Mehr...

Kopfzeile: #include <QGraphicsDropShadowEffect>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Vererbt: 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

Reimplementierte ö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 d)
void setOffset(qreal dx, qreal dy)
void setXOffset(qreal dx)
void setYOffset(qreal dy)

Signale

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

Reimplementierte geschützte Funktionen

virtual void draw(QPainter *painter) override

Detaillierte 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() geändert werden und der Unschärferadius des Schlagschattens kann mit der Funktion setBlurRadius() geändert werden.

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 verschwimmt. Der Abstand des Schlagschattens wird in Gerätekoordinaten angegeben.

Siehe auch QGraphicsBlurEffect, QGraphicsColorizeEffect, und QGraphicsOpacityEffect.

Dokumentation der Eigenschaft

blurRadius : qreal

Diese Eigenschaft gibt den Unschärferadius des Schlagschattens in Pixeln an.

Ein kleinerer Radius führt zu einem schärferen Schatten, während ein größerer Radius zu einem unschärferen Schatten führt.

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 enthält die Farbe des Schlagschattens.

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 nach rechts unten.

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

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void offsetChanged(const QPointF &offset)

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

xOffset : qreal

Diese Eigenschaft enthält den horizontalen Schattenversatz in Pixeln.

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 enthält den vertikalen Schattenversatz in Pixeln.

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)

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

[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()

Zerstört die Wirkung.

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

Dieses Signal wird ausgegeben, wenn sich der Unschärferadius des Effekts ändert. Der Parameter blurRadius enthält den neuen Unschärferadius des Effekts.

Hinweis: Meldesignal für die Eigenschaft blurRadius.

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

Reimplements: QGraphicsEffect::boundingRectFor(const QRectF &rect) const.

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

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

Hinweis: Meldesignal für die Eigenschaft color.

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

Reimplements: QGraphicsEffect::draw(QPainter *Painter).

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

Dieses Signal wird ausgegeben, wenn sich der Schattenversatz des Effekts ändert. Der Parameter offset enthält den neuen Schattenversatz des Effekts.

Hinweis: Benachrichtigungssignal für die Eigenschaft offset. Benachrichtigungssignal für die Eigenschaft xOffset. Benachrichtigungssignal für die Eigenschaft yOffset.

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