En esta página

QGraphicsDropShadowEffect Class

La clase QGraphicsDropShadowEffect proporciona un efecto de sombra. Más...

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

Propiedades

Funciones públicas

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

Funciones públicas reimplementadas

virtual QRectF boundingRectFor(const QRectF &rect) const override

Ranuras públicas

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)

Señales

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

Funciones protegidas reimplementadas

virtual void draw(QPainter *painter) override

Descripción detallada

Un efecto de sombra paralela renderiza la fuente con una sombra paralela. El color de la sombra puede modificarse con la función setColor(). El desplazamiento de la sombra puede modificarse mediante la función setOffset() y el radio de desenfoque de la sombra puede modificarse mediante la función setBlurRadius().

Por defecto, la sombra paralela es una sombra semitransparente de color gris oscuro (QColor(63, 63, 63, 180)), difuminada con un radio de 1 en un desplazamiento de 8 píxeles hacia la parte inferior derecha. El desplazamiento de la sombra se especifica en coordenadas de dispositivo.

Efecto de sombra paralela en la imagen de un pez

Véase también QGraphicsBlurEffect, QGraphicsColorizeEffect, y QGraphicsOpacityEffect.

Documentación de propiedades

blurRadius : qreal

Esta propiedad contiene el radio de desenfoque en píxeles de la sombra.

Un radio menor da como resultado una sombra más nítida, mientras que un radio mayor da como resultado una sombra más borrosa.

Por defecto, el radio de desenfoque es de 1 píxel.

Funciones de acceso:

qreal blurRadius() const
void setBlurRadius(qreal blurRadius)

Señal del notificador:

void blurRadiusChanged(qreal blurRadius)

Véase también color() y offset().

color : QColor

Esta propiedad contiene el color de la sombra.

Por defecto, el color de la gota es un gris oscuro semitransparente (QColor(63, 63, 63, 180)).

Funciones de acceso:

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

Señal del notificador:

void colorChanged(const QColor &color)

Véase también offset() y blurRadius().

offset : QPointF

Esta propiedad contiene el desplazamiento de la sombra en píxeles.

Por defecto, el desplazamiento es de 8 píxeles hacia la parte inferior derecha.

El desplazamiento se da en coordenadas de dispositivo, lo que significa que no se ve afectado por la escala.

Funciones de acceso:

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

Señal notificadora:

void offsetChanged(const QPointF &offset)

Véase también xOffset(), yOffset(), blurRadius() y color().

xOffset : qreal

Esta propiedad contiene el desplazamiento horizontal de la sombra en píxeles.

Por defecto, el desplazamiento horizontal de la sombra es de 8 píxeles.

Funciones de acceso:

qreal xOffset() const
void setXOffset(qreal dx)

Señal notificadora:

void offsetChanged(const QPointF &offset)

Véase también yOffset() y offset().

yOffset : qreal

Esta propiedad contiene el desplazamiento vertical de la sombra en píxeles.

Por defecto, el desplazamiento vertical de la sombra es de 8 píxeles.

Funciones de acceso:

qreal yOffset() const
void setYOffset(qreal dy)

Señal notificadora:

void offsetChanged(const QPointF &offset)

Véase también xOffset() y offset().

Documentación de las funciones miembro

QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)

Construye una nueva instancia de QGraphicsDropShadowEffect. El parámetro parent se pasa al constructor de QGraphicsEffect.

[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()

Destruye el efecto.

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

Esta señal se emite cada vez que cambia el radio de desenfoque del efecto. El parámetro blurRadius contiene el nuevo radio de desenfoque del efecto.

Nota: Señal notificadora para la propiedad blurRadius.

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

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

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

Esta señal se emite cada vez que cambia el color del efecto. El parámetro color contiene el nuevo color del efecto.

Nota: Señal notificadora para la propiedad color.

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

Reimplementa: QGraphicsEffect::draw(QPainter *painter).

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

Esta señal se emite cada vez que cambia el desplazamiento de la sombra del efecto. El parámetro offset contiene el nuevo desplazamiento de sombra del efecto.

Nota: Señal notificadora para las propiedades offset, xOffset, y 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.